Requests an audit of connection data for the next connection following the connection specified by the spInstId field of the connID parameter.
DWORD SCCPConnAuditRqst ( CTAHD ctahd, SccpConnId *connId)
|
Argument |
Description |
|
ctahd |
Natural Access handle returned by ctaCreateContext. |
|
connId |
Pointer to the connection ID. |
|
Return value |
Description |
|
SCCP_SUCCESS |
|
|
SCCPERR_RESOURCES |
Number of available buffers is exhausted. |
|
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. |
A successful call to this function results in a SCCPCONNAUDCFM event generated to the calling application, containing either connection data (connection ID, calling and called addresses, connection state) or an indication that there are no more connections to audit.
This function is typically used to sequentially retrieve data on all in-progress connections. On the first call, the connId->spInstId field is set to zero. This setting causes the SCCP layer to return audit data on the first in-progress connection in its internal connection tables. On subsequent calls, the application specifies the connection ID returned with the previous SCCPCONNAUDCFM event containing connection data. This sequence continues until the SCCP layer returns a SCCPCONNAUDCFM event with an event type indicating that there are no more connections to audit.
Refer to Connection auditing for more information.