SimWritePhonebookEntry
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.
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.lpPhonebookEntry
Points to a phonebook entry structure.
Return Values
HRESULTs are either S_OK for success, or one of the SIM_E error constants defined in the SIM Manager Error Constants table.
Requirements
Smartphone: Smartphone 2002 and later
Pocket PC: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: simmgr.h
Library: cellcore.lib
See Also
Send Feedback on this topic to the authors