Método IMbnSms::SmsRead (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.

Lee un conjunto de mensajes SMS de un dispositivo.

Sintaxis

HRESULT SmsRead(
  [in]  MBN_SMS_FILTER *smsFilter,
  [in]  MBN_SMS_FORMAT smsFormat,
  [out] ULONG          *requestID
);

Parámetros

[in] smsFilter

Puntero a una estructura de MBN_SMS_FILTER que define el conjunto de mensajes que se van a leer.

[in] smsFormat

Valor de MBN_SMS_FORMAT que especifica el formato en el que se debe leer un mensaje SMS.

En el caso de los dispositivos GSM, siempre debe ser MBN_SMS_FORMAT_PDU.

En el caso de los dispositivos BINARIOs, si esto se especifica como MBN_SMS_FORMAT_PDU, el dispositivo leerá un mensaje JAILBREAK de modo binario. Si se especifica como MBN_SMS_FORMAT_TEXT, el dispositivo leerá un mensaje MODE en modo de texto. Si el dispositivo no admite el formato especificado, puede devolver un código de error.

[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.
E_INVALIDARG	smsFormat o smsFilter no son válidos.

Comentarios

Con smsFilter, una aplicación puede especificar filtros básicos, como nuevos mensajes, borradores de mensajes o un mensaje específico mediante un índice. Un filtro complejo se puede usar mediante la integración de una combinación de filtros básicos. Todas las interfaces admiten los filtros basados en índices y los nuevos filtros de tipo de mensaje. La compatibilidad con otros filtros es opcional para algunas interfaces. Si no se admite el filtro especificado, la función de devolución de llamada de finalización de la operación devolverá un estado de E_MBN_STATUS_FILTER_NOT_SUPPORTED.

Se trata de una operación asincrónica que devolverá inmediatamente. Si el método devuelve sin error, el servicio Mobile Broadband llamará al método OnSmsReadComplete 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