Share via


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