XXX_Send (Compact 2013)

3/26/2014

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.

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 that contains the incoming message body to be sent.

• dwDataSize
  [in] Size of the message body, in bytes.

• pbProviderSpecificData
  [in] Buffer that contains 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 that specifies the encoding type. This value can be set to SMSDE_OPTIMAL=0, SMSDE_GSM, or SMSDE_UCS2. The value specifies the preferred encoding scheme, but the preferred scheme may not be used if it does not support specific characters. 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 Radio Interface Layer (RIL) message that contains default fields common to all providers that are already populated by the router. These default values may be overwritten by the provider.

• smsmsmSendMessageFunction
  [in] A function pointer to the SMSManagerSendMessage function that is defined by SMS_MANAGER_SEND_MESSAGE. The SMS router implements this function and sends the message using RIL.

Return Value

Returns a standard HRESULT error code.

Remarks

The SMS router implements the function specified by smsmsmSendMessageFunction and sends the message using RIL.

Requirements

See Also

Reference

Short Message Service Provider Functions
Short Message Service Provider Reference