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 reads phonebook entries from the specified range of indices of the current storage location.

Note:
You must implement these functions if your device supports IAP USIMs that support contacts with a varying number of fields, such as 1000 contacts, but only 256 total email addresses.

Syntax 

HRESULT RIL_ReadPhonebookEntries(
  HRIL 
hRil,
  DWORD 
dwStartIndex,
  DWORD 
dwEndIndex
);

Parameters

hRil

Handle to the RIL instance returned by RIL_Initialize.

dwStartIndex

Specifies the starting range index.

dwEndIndex

Specifies the ending range index.

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 asychronous result of RIL_RESULT_OKindicates success. The lpDatanotification parameter points to an array of RILPHONEBOOKENTRYstructures.

Remarks

The RIL proxy translates the RIL_ReadPhonebookEntriesfunction into IOCTL_RIL_ReadPhonebookEntrieswhen 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