# nccSetBilling

Sets billing information relative to an incoming call.

#### Prototype

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 Natural Access billing parameter structure. For a protocol-independent application using default parameters, pass NULL. See your protocol-specific documentation for details.

#### Return values

Return value | Description
SUCCESS |
CTAERR_INVALID_HANDLE | The NCC service 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.

#### Events

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

#### Details

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.