# Getting caller address information (caller ID)

Most protocols support caller ID: the ability of the called party to determine the address (and sometimes other information) of the calling party. Often, the caller ID service is available from the telephone company on a subscription basis only.

The application can call nccQueryCapability to determine if a protocol supports caller ID.

The NCCEVN_INCOMING_CALL event indicates that the protocol has received all calling party information necessary to set up the call. To retrieve caller ID (and other information), invoke nccGetCallStatus with a call handle. Information is returned in the NCC_CALL_STATUS structure. Refer to nccGetCallStatus for more detail on this structure.

Because the data is stored in this structure on a call-by-call basis, applications must analyze the call status of every incoming call to retrieve call information. Protocol-specific parameters determine how many digits to receive and how to interpret incoming digits. For details, see your protocol documentation.