Compartir a través de

Método IMbnSms::SmsSendAdvisor (mbnapi.h)

  • Artículo

Importante

A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.

Envía un mensaje en formato STORAGE.

Sintaxis

HRESULT SmsSendCdma(
  [in]  LPCWSTR               address,
  [in]  MBN_SMS_CDMA_ENCODING encoding,
  [in]  MBN_SMS_CDMA_LANG     language,
  [in]  ULONG                 sizeInCharacters,
  [in]  SAFEARRAY             *message,
  [out] ULONG                 *requestID
);

Parámetros

[in] address

Cadena terminada en null que contiene el número de teléfono del receptor. El tamaño máximo de la cadena es de 15 dígitos.

[in] encoding

Valor MBN_SMS_CDMA_ENCODING que especifica la codificación de datos.

[in] language

Valor MBN_SMS_CDMA_LANG que especifica el idioma.

[in] sizeInCharacters

Número de caracteres codificados en el mensaje. Esto puede ser diferente del tamaño de la matriz de mensajes.

[in] message

Matriz de bytes que contiene el mensaje de FRAMEWORK codificado.

El tamaño máximo de esta matriz es la propiedad ShortMsgSize de IMbnSmsConfiguration, pero esto no puede ser mayor que MBN_CDMA_SHORT_MSG_SIZE_MAX (160).

[out] requestID

Puntero a un identificador de solicitud emitido por el servicio de banda ancha móvil para identificar esta solicitud.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 El servicio de banda ancha móvil no se está ejecutando en este sistema.
E_HANDLE
 La interfaz no es válida, lo más probable es que el dispositivo se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 La interfaz no es válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 El dispositivo no admite el envío de mensajes SMS en el formato solicitado. Por ejemplo, si se llama a esta función para un dispositivo GSM.

Comentarios

Este método se puede usar para enviar un mensaje SMS para un dispositivo FRAMEWORK. Sin embargo, esto es solo cuando el dispositivo DEVICE admite el envío de SMS. Una aplicación de llamada puede aprender si el dispositivo admite este formato llamando al método GetInterfaceCapability de IMbnInterface. A continuación, puede buscar MBN_SMS_CAPS_TEXT_SEND en el miembro smsCaps de MBN_INTERFACE_CAPS.

El parámetro address puede estar en cualquiera de estos formatos.

  • "+ <Número del> Centro de servicio SMS de código><internacional de país\0"
  • "<Sms Service Center Number>\0"

Se trata de una operación asincrónica que devolverá inmediatamente. Si el método devuelve sin error, el servicio de banda ancha móvil llamará al método OnSmsSendComplete de la interfaz IMbnSmsEvents .

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado mbnapi.h

Consulte también

IMbnSms