Externalmodulesocketfree - Newport XPS Programmer's Manual

XPS Unified
EDH0373En1023 — 01/18
7.2.1.32

ExternalModuleSocketFree

Name
ExternalModuleSocketFree – Free the socket previously reserved for an
ExternalModule.
Input tests
- Refer to section 7.1: "Input Tests Common to all XPS Functions".
- Checks the module number (must >=1 and <= NbExternalModules): (-17)
Here: NbExternalModules is the number of modules declared in the line
SharedLibraryModuleNames of system.ref
Description
This function frees the socket previously reserved for an ExternalModule. If the
function is executed successfully via this socket all the controller functions (like
FirmwareVersionGet(), ElapsedTimeGet( , ErrorStringGet(), ...) become active, while
ExternalModule functions (like ExternalModuleTZPositionCurrentGet(),
ExternalModuleGPIODigitalInputGet(), ...) become inactive.
(return error -18: Positioner Name doesn't exist or unknown command).
Prototype
int ExternalModuleSocketFree(
int SocketID,
int ModuleNumber
)
Input parameters
SocketID
ModuleNumber
Output parameters
None
Return (In addition to the results of "Input Tests Common to all XPS
Functions")
• 0: No error.
• -17: Parameter out of range or incorrect.
int Socket identifier gets by the
"TCP_ConnectToServer" function.
int External module number
78
Programmer's Manual