Table 7- 120 Retrievestorage() - Native C - Siemens Simatic S7-1500 Function Manual

RetrieveStorage()
RetrieveStorage()
virtual controller must be in OFF operating state for this.

Table 7- 120 RetrieveStorage() - Native C++

Syntax
Parameters
Return values
Table 7- 121 RetrieveStorage() - .NET (C#)
Syntax
Parameters
Return values
Exceptions
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
creates a Virtual SIMATIC Memory Card from the archived ZIP file. The
ERuntimeErrorCode RetrieveStorage(
WCHAR* in_FullFileName
);
•
WCHAR* in_FullFileName:
The full path to the ZIP file. The path relates to directories of the computer
where the API is being called.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INVALID_OPERATING_STATE
SREC_INVALID_ARCHIVE_PATH
SREC_DELETE_EXISTING_STORAGE_FAI
LED
SREC_RETRIEVE_STORAGE_FAILURE
SREC_STORAGE_TRANSFER_ERROR
void RetrieveStorage(
string in_FullFileName
);
•
string in_FullFileName:
The full path to the ZIP file. The path relates to directories of the computer
where the API is being called.
None
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
ERuntimeError-
Code.InvalidOperatingState
ERuntimeError-
Code.InvalidArchivePath
ERuntimeError-
Code.DeleteExistingStorageFailed
ERuntimeError-
Code.RetrieveStorageFailure
ERuntimeError-
Code.StorageTransferError
User interfaces (API)
7.6 API IInstances
Condition
The function is successful.
The instance is not registered in Runtime
Manager.
The function does not return on time.
The instance is not in OFF operating
state.
The archive path is invalid.
The old storage cannot be deleted.
The ZIP file cannot be unzipped.
Error during network data transfer.
Memory data between client and server
computers do not match.
Condition
The instance is not registered in Runtime
Manager.
The function does not return on time.
The instance is not in OFF operating
state.
The archive path is invalid.
The old storage cannot be deleted.
The ZIP file cannot be unzipped.
Error during network data transfer.
Memory data between client and server
computers do not match.
143