SimReadPhonebookEntry

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The SimReadPhonebookEntry function reads a phone book entry from the SIM card. This function is part of the SIM Manager API set that enables access to information stored on the SIM card.

Syntax

HRESULT SimReadPhonebookEntry (
  HSIM hSim,
  DWORD dwLocation,
  DWORD dwIndex,
  LPSIMPHONEBOOKENTRY lpPhonebookEntry
);

Parameters

• hSim
  Contains a valid HSIM handle.

• dwLocation
  A phone book storage location value; equal to one of the SIM_PBSTORAGE constant values.

  Value	Description
  SIM_PBSTORAGE_EMERGENCY	Emergency dial list.
  SIM_PBSTORAGE_FIXEDDIALING	SIM fixed dialing list.
  SIM_PBSTORAGE_LASTDIALING	SIM last dialing list.
  SIM_PBSTORAGE_OWNNUMBERS	SIM own numbers lists.
  SIM_PBSTORAGE_SIM	General SIM Storage.

• dwIndex
  Index of the entry to retrieve.

• lpPhonebookEntry
  A pointer to a phone book entry structure.

Return Value

HRESULTs are either S_OK for success, or one of the SIM_E error constants defined in the SIM Manager Error Constants table.

Requirements

See Also

Reference

SIMPHONEBOOKENTRY