WPD_COMMAND_SMS_SEND Command

banner art

The WPD_COMMAND_SMS_SEND command initiates the sending of a short message service (SMS) message by an SMS functional object.

Command category

WPD_CATEGORY_SMS

Parameters

The driver expects the following parameters.

Parameter	VarType	Description
WPD_PROPERTY_COMMON_COMMAND_TARGET	VT_LPWSTR	Required. The object ID of the SMS functional object that should send the message. Different SMS functional objects can have different settings.
WPD_PROPERTY_SMS_RECIPIENT	VT_LPWSTR	Required. The URI of the recipient.
WPD_PROPERTY_SMS_MESSAGE_TYPE	VT_UI4	Required. An SMS_MESSAGE_TYPES enumerator that indicates the type of message (text or binary).
WPD_PROPERTY_SMS_TEXT_MESSAGE	VT_LPWSTR	Optional. If WPD_PROPERTY_SMS_MESSAGE_TYPE indicates a text message, this is the message string; otherwise, this parameter is not included.
WPD_PROPERTY_SMS_BINARY_MESSAGE	VT_VECTOR\|VT_UI1	Optional. If WPD_PROPERTY_SMS_MESSAGE_TYPE indicates a binary message, this is a pointer to an array of bytes; otherwise, this parameter is not included. The first DWORD of the value is the length of the array, in bytes.

Return Values

The driver should return the following results.

Result	VarType	Description
WPD_PROPERTY_COMMON_HRESULT	VT_ERROR	Required. An HRESULT that indicates success or failure to carry out the command. If the caller is making an invalid request, the driver should return HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) and is not required to return any other result values. Error codes include Windows Portable Devices error codes or any other appropriate error codes.
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE	VT_UI4	Optional. A driver-specific error code. This is typically only used for driver testing, or if the driver, device, and client are all designed together.

Calling Methods

Can only be called directly using IPortableDevice::SendCommand.

Requirements

Header: Defined in PortableDevice.h

See Also

Additional resources