SimWritePhonebookEntryEx

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The SimWritePhonebookEntryEx function writes extended phone book entries on the SIM card. This function is part of the SIM Manager API set that enables access to information stored on the SIM or USIM card.

Syntax

HRESULT SimWritePhonebookEntryEx(
  HSIM hSim,
  DWORD dwLocation,
  DWORD dwIndex,
  LPSIMPHONEBOOKENTRYEX lpEntries
);

Parameters

• hSim
  Points to 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. It may be SIM_PBINDEX_FIRSTAVAILABLE.

• lpPhonebookEntry
  Points to an extended 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.

Remarks

Requirements

Header	simmgr.h
Library	cellcore.lib