RIL_WritePhonebookEntryEx (Compact 2013)
3/26/2014
This function writes a Universal Subscriber Identity Module (USIM) phone book entry to the current storage location.
Syntax
HRESULT RIL_WritePhonebookEntryEx(
HRIL hRil,
const RILPHONEBOOKENTRYEX* lpEntry
);
Parameters
- hRil
Handle to the Radio Interface Layer (RIL) instance returned by RIL_Initialize.
- lpEntry
Phone book entry to write. The RILPHONEBOOKENTRYEX structure of the phone book entry to write.
Return Value
The immediate HRESULT return code values are:
Value |
Description |
|---|---|
Any positive value |
The function completed successfully. The return code is the command identifier. |
Zero |
Unused. |
E_INVALIDARG |
One or more of the parameters is invalid. |
Any other negative value |
An error value that is defined in the Ril.h file. |
Remarks
The function immediately returns a command identifier, and two asynchronous results occur sometime later.
The asynchronous results call the RILNOTIFYCALLBACK and RILRESULTCALLBACK callback functions registered by using the pfnResult and pfnNotify parameters of RIL_Initialize.
The first asynchronous result calls RILRESULTCALLBACK with the following values:
Parameter |
Value |
dwCode |
RIL_RESULT_OK |
hrCmdID |
The command identifier |
lpData |
NULL |
The second asynchronous result calls RILNOTIFYCALLBACK with the following values:
Parameter |
Value |
dwCode |
RIL_NOTIFY_PHONEBOOKENTRYSTORED. For more information, see Notification Phonebook Constants. |
hrCmdID |
The command identifier. |
lpData |
A pointer to the storage index of the entry. |
If an error occurs, HRESULT and dwCode contain appropriate error codes.
The RIL proxy translates this function into IOCTL_RIL_WritePhonebookEntryEx when the RIL proxy calls RIL_IOControl.
Requirements
Header |
ril.h |
Library |
Ril.lib |