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

Obtiene el estado de SMS de un dispositivo.

Sintaxis

HRESULT GetSmsStatus(
  [out] MBN_SMS_STATUS_INFO *smsStatusInfo
);

Parámetros

[out] smsStatusInfo

Puntero a una estructura de MBN_SMS_STATUS_INFO , que contiene la información de estado del dispositivo.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_PENDING	El estado de SMS no está disponible. El servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. La aplicación que realiza la llamada se puede notificar cuando el estado de SMS está disponible registrando para el método OnSmsStatusChange de la interfaz IMbnSmsEvents .
E_MBN_PIN_REQUIRED	Se requiere un PIN para obtener esta información.
E_MBN_SIM_NOT_INSERTED	No se inserta una SIM en el dispositivo.
E_MBN_BAD_SIM	Se inserta una SIM incorrecta en el dispositivo.

Comentarios

En el caso de errores recuperables, como E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED y E_MBN_BAD_SIM, el servicio de banda ancha móvil consultará de nuevo el dispositivo para obtener esta información cuando finalice la condición de error. Por ejemplo, si el dispositivo requiere que se escriba un PIN para recuperar esta información, devolverá E_MBN_PIN_REQUIRED. Cuando una aplicación entra en el PIN para desbloquear el dispositivo, el servicio de banda ancha móvil volverá a intentar obtener esta información del dispositivo. El servicio de banda ancha móvil llamará al método OnSmsStatusChange de la interfaz IMbnSmsEvents .

El estado del almacén de mensajes SMS puede cambiar debido a un nuevo mensaje recibido por el sistema. En cualquier cambio en el estado del almacén de mensajes, el servicio de banda ancha móvil llamará al método OnSmsStatusChange de la interfaz IMbnSmsEvent .

Las operaciones emitidas por la aplicación, como la lectura o eliminación de mensajes, pueden restablecer la marca en MBN_SMS_STATUS_INFO estructura. Un cambio en el almacén de SMS causado por este restablecimiento no dará lugar a la llamada de ningún método de notificación.

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