Método IMbnSms::SmsSendAdvisor (mbnapi.h)
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 |
---|---|
|
El método se completó correctamente. |
|
El servicio de banda ancha móvil no se está ejecutando en este sistema. |
|
La interfaz no es válida, lo más probable es que el dispositivo se haya quitado del sistema. |
|
La interfaz no es válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema. |
|
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 |