nccQueryCapability

Queries the capabilities of the signaling protocol.

Prototype

DWORD nccQueryCapability ( CTAHD linehd, NCC_PROT_CAP *protcap, unsigned size )

Argument	Description
linehd	Context handle used to open the NCC API instance.
protcap	A pointer to an NCC_PROT_CAP structure to hold returned protocol capability information. typedef struct { DWORD size; DWORD capabilitymask; } NCC_PROT_CAP; See the Details section for field descriptions.
size	The size of NCC_PROT_CAP structure.

Return values

Return value	Description
SUCCESS
CTAERR_INVALID_HANDLE	The NCC API is not open on the specified handle.
CTAERR_INVALID_STATE	The line linehd is in uninitialized state.
CTAERR_SVR_COMM	A server communication error occurred.

Details

nccQueryCapability queries the capabilities of the protocol on a specified line. Use this function to determine if the current protocol supports a given feature. nccQueryCapability returns an NCC_PROT_CAP structure containing capability information for the protocol.

The NCC_PROT_CAP structure contains the following fields:

Field	Description
size	Number of bytes written at the address pointed to by protcap.
capabilitymask	A bit mask of features implemented by this protocol. See Protocol capabilities for a list of capabilities.