PHAddSpeedDialEntry (Windows Embedded CE 6.0)

1/6/2010

This function adds a speed dial entry to the list of speed dial entries. It does this by remoting into the IP Contacts sample application where a new speed dial entry form is brought up and is pre-populated with the desired data.

Syntax

HRESULT  PHAddSpeedDialEntry(
    PH_SPEEDDIAL_ENTRY* pEntry
);

Parameters

• pEntry
  [in] A pointer to a PH_SPEEDDIAL_ENTRY structure that contains the information about the speed dial entry to add to the Caller Info Database.

Return Value

The function returns an HRESULT indicating if the call succeeded or failed. The following table shows additional possible return values.

Value	Description
E_POINTER	Invalid pointer.
E_FAIL	Failure.
S_OK	Success.
E_INVALIDARG	The passed pointer is invalid, possibly because it is not the size of a PH_SPEEDDIAL_ENTRY structure, or because one or more members of the structure are invalid.

Remarks

Note

This documentation applies to functionality implemented in sample code for PhCommon. For more information, see PhCommon Reference.

This function invokes the IP Contacts application, which is part of the sample code, IP Phone Suite. It invokes phinfo.exe and tells it to add the speed dial entry to its list of contacts in the Caller Info Database.

Requirements

Header	databaseapi.hpp
Library	PhCommon.dll
Windows Embedded CE	Windows Embedded CE 6.0 and later

See Also

Reference

PhCommon SpeedDial APIs
PhCommon Reference
IVoIPCallerInfoDB