RIL_GetCallForwardingSettings

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves current call forwarding rules.

Syntax

HRESULT RIL_GetCallForwardingSettings(
  HRIL hRil,
  DWORD dwReason,
  DWORD dwAddressId
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwReason
  Specifies the forwarding reason to retrieve the settings. For values, see Forwarding Reason Constants.

• dwAddressId
  Specifies the address ID of the line on which to get call forwarding settings. For values, see Information Class Constants.

Return Value

Positive HRESULT values indicate success and are used as command identifications for matching the asynchronous call result. Negative HRESULT values indicate an error. Errors are defined in the Ril.h file.

An asynchronous result of RIL_RESULT_OK indicates success. The lpData notification parameter points to an array of RILCALLFORWARDINGSETTINGS structures.

Remarks

The RIL proxy translates the RIL_GetCallForwardingSettings function into IOCTL_RIL_GetCallForwardingSettings when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
RILCALLFORWARDINGSETTINGS
Forwarding Reason Constants
Information Class Constants