SimWritePhonebookTag

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The SimWritePhonebookTag writes the name value for a given index and tag. This function is part of the SIM Manager API set that enables access to information stored on the USIM card.

Syntax

HRESULT SimReadPhonebookTag(
  HSIM hSim,
  DWORD dwTag,
  DWORD dwIndex,
  LPSTR szName
);

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 tag to read.

• szName
  Name for index.

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

SimReadPhonebookTag