Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function sets the current or default address identification for devices that support multiple device addresses. This address ID is used for subsequent outgoing calls as well as for line specific settings, such as call forwarding.

Syntax 

HRESULT RIL_SetCurrentAddressId(
  HRIL 
hRil,
  DWORD 
dwAddressId
);

Parameters

hRil

Handle to the RIL instance returned by RIL_Initialize.

dwAddressId

Specifies the new current address ID. This value must be a valid address ID from a RILSUBSCRIBERINFOstructure returned by RIL_GetSubscriberNumbers.

Return Value

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

An asynchronous result of RIL_RESULT_OKindicates success. The lpDatanotification parameter is set to NULL.

Remarks

This function is used in alternate line support (ALS) scenarios to set the current line to be used for outgoing calls as well as for line related settings.

The RIL proxy translates the RIL_SetCurrentAddressIDfunction into IOCTL_RIL_SetCurrentAddressIDwhen the RIL proxy calls RIL_IOControl.

Requirements

Header ril.h
Library Ril.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also