Shutdownandfreeapi(); Table 7- 24 Shutdownandfreeapi() - Native C - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.3 Shut down API
7.3.1.4

ShutdownAndFreeApi()

Description
The
IRuntimeManager interface and unloads the library of the Runtime API.
This function can only be called after the successful call of the
InitializeApi
Funktion
Table 7- 24
Syntax
Parameters
Return values
Example C++
104
function shuts down the Runtime API, deletes the
ShutdownAndFreeApi()
function was not called, the library must be unloaded using the Win32 API-
.
FreeLibrary()
ShutdownAndFreeApi() - Native C++
ERuntimeErrorCode ShutdownAndFreeApi(
ISimulationRuntimeManager* in_SimulationRuntimeManagerInterface
);
•
ISimulationRuntimeManager* in_SimulationRuntimeManagerInterface:
The interface of the Runtime Manager to be deleted.
Runtime error code
SREC_OK
SREC_API_NOT_INITIALIZED
SREC_WRONG_ARGUMENT
// Include The Headerfile Of The API
#include "SimulationRuntimeApi.h"
// The Interfaces
ERuntimeErrorCode result;
ISimulationRuntimeManager* api = NULL;
IInstance* instance = NULL;
// Init the API
result = InitializeApi(&api);
...
// Shutdown The API
ShutdownAndFreeApi
result =
api = NULL;
InitializeApi
Condition
The function is successful.
The function was not called
InitializeApi
successfully.
The pointer to the interface is
(api);
Function Manual, 12/2017, A5E37039512-AB
function. If the
.
NULL
S7-PLCSIM Advanced