Retrieves protocol-specific status information for a call.
DWORD nccGetExtendedCallStatus ( NCC_CALLHD callhd, void *extendedcallstatus, unsigned size )
|
Argument |
Description |
|
callhd |
Handle of the call for which you want to retrieve status information. |
|
extendedcallstatus |
A pointer to a protocol- and implementation-specific parameter structure. See the protocol-specific documentation for details. |
|
size |
The size (in bytes) of the application-supplied status information space. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_BAD_ARGUMENT |
extendedcallstatus pointer is NULL. |
|
CTAERR_BAD_SIZE |
size is smaller than the size of a DWORD. |
|
CTAERR_INVALID_HANDLE |
The call handle is not valid. It may have been released. |
|
CTAERR_SVR_COMM |
A server communication error occurred. |
|
NCCERR_NOT_CAPABLE |
The protocol does not support the ability to get extended call status information. The application can determine if the protocol supports this feature by examining the NCC_CAP_EXTENDED_CALL_STATUS bit in the capabilitymask returned by nccQueryCapability. |