WPD_COMMAND_SMS_SEND Command

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 Value

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

Requirement Value
Header
PortableDevice.h

See also

Commands