RIL_AddCallForwarding

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function adds a call forwarding rule.

Syntax

HRESULT RIL_AddCallForwarding(
  HRIL hRil,
  DWORD dwReason,
  const RILCALLFORWARDINGSETTINGS* lpSettings,
  DWORD dwAddressId
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwReason
  Specifies the reason for the call forwarding rule. For values, see Forwarding Reason Constants.

• lpSettings
  Settings for the new call forwarding rule.

• dwAddressId
  Specifies the address ID of the line on which to change call forwarding settings.

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 is set to NULL.

Remarks

The RIL proxy translates the RIL_AddCallForwarding function into IOCTL_RIL_AddCallForwarding when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
Forwarding Reason Constants