RIL_WritePhonebookEntry (Compact 2013)

3/26/2014

This function writes a phone book entry to the current storage location.

Syntax

HRESULT RIL_WritePhonebookEntry(
  HRIL hRil,
  const RILPHONEBOOKENTRY* lpEntry
);

The immediate HRESULT return code values are:

Value	Description
Any positive value	The function completed successfully. The return code is the command ID.
Zero	Unused
E_INVALIDARG	One or more of the parameters, lpEntry or raAddress or wszText, is invalid
Any other negative value	An error value that is defined in the Ril.h file.

The function immediately returns a command ID 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 is the RILRESULTCALLBACK registered function called with the following values:

The second asynchronous result is the RILNOTIFYCALLBACK registered function called with the following values:

Parameter	Value
dwCode	RIL_NOTIFY_PHONEBOOKENTRYSTORED
hrCmdID	the command ID
lpData	A pointer to the storage index of the entry. If a positive number was specified in the initial call, this will be equal to that number.

If an error occurs, HRESULT and dwCode contain appropriate error codes.

The RIL proxy translates this function into IOCTL_RIL_WritePhonebookEntry when the RIL proxy calls RIL_IOControl.

Header	ril.h
Library	Ril.lib