Sets billing information relative to an incoming call.
DWORD nccSetBilling ( NCC_CALLHD callhd, unsigned rate void *billingparms )
|
Argument |
Description |
|
callhd |
Handle of the incoming call. |
|
rate |
Billing rate (a country-dependent unit of cost). |
|
billingparms |
Pointer to a protocol-specific NaturalAccess billing parameter structure. For a protocol-independent application using default parameters, pass NULL. See your protocol-specific documentation for details. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_INVALID_HANDLE |
The NCC API is not open on the specified handle. |
|
CTAERR_INVALID_STATE |
The line is not in the appropriate state to invoke this function. |
|
CTAERR_SVR_COMM |
A server communication error occurred. |
|
NCCERR_INVALID_CALL_STATE |
The call is not in the appropriate state to invoke this function. |
|
NCCERR_NOT_CAPABLE |
The protocol does not support the capability of setting billing. |
|
Event |
Description |
|
NCCEVN_BILLING_SET |
The billing information was successfully sent to the network. The value field contains one of the following: NCC_BILLINGSET_DEFAULT Billing rate set to default value NCC_BILLINGSET_FREE Billing rate free (billing rate) Billing rate value |
nccSetBilling sets billing information relative to an incoming call.
Some protocols do not support the capability of setting billing. The application can determine if the protocol supports this capability by examining the NCC_CAP_SET_BILLING bit in the capabilitymask returned by nccQueryCapability.