RIL_ReadPhonebookEntries

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

  • dwStartIndex
    Specifies the starting range index.
  • dwEndIndex
    Specifies the ending range index.

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 asychronous result of RIL_RESULT_OK indicates success. The lpData notification parameter points to an array of RILPHONEBOOKENTRY structures.

Remarks

The RIL proxy translates the RIL_ReadPhonebookEntries function into IOCTL_RIL_ReadPhonebookEntries when 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

Reference

RIL_Initialize
RILPHONEBOOKENTRY