Método IMbnSms::GetSmsConfiguration (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 la configuración de SMS de un dispositivo.
Sintaxis
HRESULT GetSmsConfiguration(
[out, retval] IMbnSmsConfiguration **smsConfiguration
);
Parámetros
[out, retval] smsConfiguration
Interfaz IMbnSmsConfiguration que representa la configuración de SMS del dispositivo.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. |
|
La configuración 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 la configuración de SMS está disponible registrando para el método OnSmsConfigurationChange de la interfaz IMbnSmsEvents . |
|
Se requiere un PIN para obtener esta información. |
|
No hay ningún SIM en el dispositivo. |
|
Hay una SIM incorrecta en el dispositivo. |
|
El dispositivo no admite SMS. |
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 OnSmsConfigurationChange de la interfaz IMbnSmsEvents .
La configuración de SMS se puede actualizar mediante la red o el dispositivo sin ninguna solicitud de cambio por parte de ninguna aplicación. En tal caso, el servicio de banda ancha móvil notificará a todas las aplicaciones registradas llamando al método OnSmsConfigurationChange 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 |