SimWritePhonebookEntry
A version of this page is also available for
4/8/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
| Header | simmgr.h |
| Library | cellcore.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |