|
|
|
|
This verb disconnects an application from a node, freeing all resources associated with that connection. The node from which the application wants to disconnect is identified by the target_handle parameter on the call.
typedef struct disconnect_ms_node
{
AP_UINT16 opcode; /* Verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* Primary return code */
AP_UINT32 secondary_rc; /* Secondary return code */
} DISCONNECT_MS_NODE;
An application supplies the following parameter when it issues DISCONNECT_MS_NODE:
After the verb executes, SNAP-IX returns parameters to indicate whether the execution was successful and, if not, to indicate the reason the execution was not successful.
If the verb executes successfully, SNAP-IX returns the following parameter:
AP_OK
SNAP-IX does not return a secondary_rc when the verb executes successfully.
When a verb does not execute successfully, SNAP-IX returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
If the verb does not execute because of a parameter error, SNAP-IX returns the following parameters:
AP_PARAMETER_CHECK
The supplied target handle was not a valid value returned on a previous CONNECT_MS_NODE verb.
If the verb does not execute because of a state error, SNAP-IX returns the following parameters:
AP_STATE_CHECK
One of the following:
The application issued DISCONNECT_MS_NODE while CONNECT_MS_NODE or a previous DISCONNECT_MS_NODE was still outstanding.
The application used the synchronous entry point to issue this verb, but another synchronous verb was in progress for this target handle. Only one synchronous verb can be in progress on a particular target handle at any time.
The application issued DISCONNECT_MS_NODE while a previous asynchronous MS verb was still outstanding.
The application used the synchronous MS entry point to issue this verb within a callback routine. The application must use the asynchronous entry point to issue any verb from a callback routine.
If the verb does not execute successfully because the SNAP-IX software is not active, SNAP-IX returns the following parameter:
The SNAP-IX software has failed.
SNAP-IX does not return a secondary_rc when the SNAP-IX software is not active.
If the verb does not execute because of a system error, SNAP-IX returns the following parameters:
An operating system call failed during processing of the verb.
The return code from the operating system call. For the meaning of this return code, check the returned value in the file /usr/include/sys/errno.h .
|
|
|
 |
|