Compartir a través de

Método IMbnSmsEvents::OnSmsReadComplete (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.

Método de notificación que indica la finalización de una operación de lectura de mensajes.

Sintaxis

HRESULT OnSmsReadComplete(
  [in] IMbnSms        *sms,
  [in] MBN_SMS_FORMAT smsFormat,
  [in] SAFEARRAY      *readMsgs,
  [in] VARIANT_BOOL   moreMsgs,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parámetros

[in] sms

Interfaz IMbnSms que representa el almacén de mensajes que completó la operación.

[in] smsFormat

Valor MBN_SMS_FORMAT que define el formato del mensaje SMS.

[in] readMsgs

Matriz de mensajes leídos desde el dispositivo.

[in] moreMsgs

Valor booleano que indica si todavía se están procesando más mensajes. Si esto es TRUE, se llamará a OnSmsReadComplete repetidamente hasta que no haya más mensajes y moreMsgs sea FALSE.

[in] requestID

Identificador de solicitud asignado por el servicio de banda ancha móvil para identificar la operación de lectura de mensajes.

[in] status

Código de estado que indica el resultado de la operación.

Una aplicación que llama puede esperar uno de los siguientes valores.

Valor Significado
S_OK
 La operación se realizó correctamente.
E_MBN_SIM_NOT_INSERTED
 No hay ninguna SIM en el dispositivo.
E_MBN_BAD_SIM
 Hay una TARJETA SIM incorrecta en el dispositivo.
E_MBN_PIN_REQUIRED
 Se requiere un PIN para que se complete la operación.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 El dispositivo no admite la operación sms o el formato SMS determinado.
E_MBN_SMS_MEMORY_FAILURE
 Error de memoria de SMS.
E_MBN_SMS_INVALID_MEMORY_INDEX
 No hay ningún índice de memoria con el valor solicitado.
E_MBN_SMS_FILTER_NOT_SUPPORTED
 El dispositivo no admite el filtro solicitado.

Valor devuelto

Este método debe devolver S_OK.

Comentarios

En el caso de los dispositivos GSM, la aplicación que llama debe llamar a QueryInterface en cada elemento de readMsgs para una interfaz IMbnSmsReadMsgPdu .

En el caso de los dispositivos IOT, si smsFormat es MBN_SMS_FORMAT_TEXT, la aplicación debe llamar a QueryInterface para una interfaz IMbnSmsReadMsgTextIot ; De lo contrario, si smsFormat está MBN_SMS_FORMAT_PDU, la aplicación debe llamar a QueryInterface para una interfaz IMbnSmsReadMsgPdu .

Si una solicitud de lectura da como resultado una gran cantidad de mensajes que se leen, se puede llamar a OnSmsReadComplete repetidamente hasta que moreMsgs indique que no hay más mensajes que leer.

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

IMbnSmsEvents