Share via

XXX_Send (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function calls the function specified by the function pointer smsmsmSendMessageFunction as many times as is necessary to send the actual Short Message Service (SMS) fragments. The function specified by smsmsmSendMessageFunction is implemented in the SMS router and is responsible for sending the message using RIL.

Syntax

BOOL XXX_Send(
  SMS_MANAGER_COOKIE smsmcCookie,
  const BYTE* pbData,
  DWORD dwDataSize,
  const BYTE* pbProviderSpecificData,
  DWORD dwProviderSpecificDataSize,
  SMS_DATA_ENCODING smsdeDesiredDataEncoding,
  RILMESSAGE* prilmTemplate,
  SMS_MANAGER_SEND_MESSAGE smsmsmSendMessageFunction
);

Parameters

  • smsmcCookie
    [in] A SMS_MESSAGE_COOKIE_DATA variable. The only responsibility of the Short Message Service (SMS) provider is to pass this value to the function specified in smsmsmSendMessageFunction.
  • pbData
    [in] Buffer containing the incoming message body to be sent.
  • dwDataSize
    [in] Size of the message body, in bytes.
  • pbProviderSpecificData
    [in] Buffer containing provider-specific data that is populated by the function caller. Provider-specific data is any data in addition to the message body pointed to by pbData.
  • dwProviderSpecificDataSize
    [in] The size of the provider-specific data, in bytes.
  • smsdeDesiredDataEncoding
    [in] An enumeration to specify the encoding type. This value can be set to SMSDE_OPTIMAL=0, SMSDE_GSM, and SMSDE_UCS2. This is only the desired data encoding scheme and may not be used. For example, if SMSDE_OPTIMAL is selected for the sample GSM text provider then GSM encoding is used unless specific characters are not mapped in GSM encoding. In that case, UCS2 is used. The sample CDMA text provider only supports ASCII. The sample CDMA provider converts all outgoing messages to ASCII.
  • prilmTemplate
    [in] Pointer to a RIL message with default fields common to all providers already populated by the router. These default values may be overwritten by the provider.
  • smsmsmSendMessageFunction
    [in] A function pointer to the SMSManagerSendMessage function defined by SMS_MANAGER_SEND_MESSAGE. This function is implemented in the Short Message Service (SMS) router and is responsible for sending the message using RIL.

Return Value

Returns a standard HRESULT error code.

Requirements

Header Developer Implemented
Library Developer Implemented
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Short Message Service Provider Functions
Short Message Service Provider Reference

Concepts

Short Message Service Providers