GetSocketStatus

(RPC Manager Library)

Description:	Returns a Boolean to indicate the connection status of either, 1) The machine node if the subnet is not valid, or 2) The specified interface.
Warning:	This function should be used only by advanced programmers.
Returns:	See comments
Usage:	Steady State only.
Function Groups:	Network
Related to:
Format:	\RPCManager.GetSocketStatus(MachineName [,Subnet])
Parameters:

MachineName

Required. The name of the machine for which you wish to get the Socket status.

Subnet

An optional parameter that specifies which an interface ID or GUID the socket, in which you are interested, is on.

Comments:

This subroutine is a member of the RPC Manager's Library, and must therefore be prefaced by \RPCManager\, as shown in the "Format" section. If the application you are developing is a script application, the subroutine call must be prefaced by System\RPCManager\, and the System variable must be declared in AppRoot.src.
This module returns the status of the connection between two PCs if no Subnet is specified. If the Subnet is specified, then the return value is that of the Socket’s status on the specified Subnet. If a Subnet is not specified and you are using a multi-homed PC, the return value will indicate how many sockets are connected to a particular PC.

In a network using multi-homed PCs, it is possible for two PCs to be connected multiple times under a given Subnet. In such a case, GetSocketStatus will return the status of the first applicable socket found.

Related information:

RPC Manager Service