SimWritePhonebookEntry (Windows Embedded CE 6.0)

1/6/2010

The SimWritePhonebookEntry function writes a phone book entry to 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 SimWritePhonebookEntry (
  HSIM hSim,
  DWORD dwLocation,
  DWORD dwIndex,
  LPSIMPHONEBOOKENTRY lpPhonebookEntry
);

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 number of the entry to write to the SIM. Set it to SIM_PBINDEX_FIRSTAVAILABLE (defined as 0xffffffff) if it does not matter to which index it is written. When this parameter is set to SIM_PBINDEX_FIRSTAVAILABLE, the resulting index value of the SIMCALLBACK function will also be set to SIM_PBINDEX_FIRSTAVAILABLE or the actual index to where the entry was written.

• lpPhonebookEntry
  Points to a phonebook 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

Concepts

SIM Manager Functions