Requests the subsystem be taken out of service and have all traffic routed to its backup point code.
DWORD SCCPCoordRqst ( CTAHD ctahd, S16 spId, SccpCoordRqst *coordRqst)
Argument |
Description |
ctahd |
Natural Access handle returned by ctaCreateContext. |
spId |
SCCP service access point. |
coordRqst |
Pointer to the caller's coordrqst message structure containing the affected subsystem number. |
Return value |
Description |
SCCP_SUCCESS |
|
SCCPERR_RESOURCES |
Number of available buffers is exhausted. |
CTAERR_BAD_ARGUMENT |
One or more arguments are invalid. |
CTAERR_DRIVER_SEND_FAILED |
Error occurred accessing the CPI driver. Call SCCPGetStats to obtain the error code. The error code is in the failTxErr field of the SccpStats structure. The CPI error codes are listed in the txcpi.h include file. |
CTAERR_INVALID_CTAHD |
Natural Access handle is invalid. |
This function generates an SCCP subsystem-out-of-service-request (SOR) to the backup signaling point as specified in the SAP configuration.
Refer to Coordinated state change for more information.