Getting call status information

To retrieve call status information about a call, use nccGetCallStatus.

Prototype

DWORD NMSAPI nccGetCallStatus ( NCC_CALLHD callhd, NCC_CALL_STATUS *callstatus, unsigned size)

Argument

Description

callhd

Call handle returned to the application with the NCCEVN_SEIZURE_DETECTED event or returned from nccPlaceCall.

callstatus

Pointer to an address of a buffer to receive the call status information. This buffer must be at least the size of an NCC_CALL_STATUS structure. The following table lists the fields in the NCC_CALL_STATUS structure and indicates whether the fields are returned by SIP for NCC:

Field

Returned

size

Yes

state

Yes

calledaddr

No

callingaddr

No

callingname

Yes

pendingcmd

Yes

held

No

direction

Yes

linehd

Yes

size

Size of the buffer. This size should be set to the size of the NCC_CALL_STATUS buffer.

Example

NCC_CALL_STATUS     info;
ret = nccGetCallStatus( callhd, &info, sizeof( NCC_CALL_STATUS ) );