Método IMbnRegistration::GetProviderID (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 identificador de proveedor de la red registrada actualmente.
Sintaxis
HRESULT GetProviderID(
[out] BSTR *providerID
);
Parámetros
[out] providerID
Puntero a una cadena que contiene el identificador del proveedor registrado actualmente. La longitud máxima es MBN_PROVIDERID_LEN caracteres. La cadena solo se rellena cuando el método devuelve S_OK para que se realice correctamente. Tras el éxito, la aplicación que realiza la llamada debe liberar la memoria asignada mediante una llamada a SysFreeString.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
El identificador de proveedor no está disponible. Actualmente, el servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. Cuando el identificador de proveedor esté disponible, el servicio de banda ancha móvil llamará al método OnRegisterModeAvailable de IMbnRegistrationEvents. |
|
Se requiere un PIN para obtener el identificador del proveedor. |
|
No se inserta una SIM en el dispositivo. |
|
Se inserta una SIM incorrecta en el dispositivo. |
Comentarios
El método GetProviderID obtiene el identificador del proveedor registrado actualmente. Para el modo de selección de red automática, este es el identificador de la red a la que está registrado actualmente el dispositivo. Si el modo de selección de red es manual, este campo contendrá el identificador de proveedor de la red en la que el dispositivo intentará registrarse. En el caso de los dispositivos RECOVERY, se establece en MBN_CDMA_DEFAULT_PROVIDER_ID si no se conoce el identificador del proveedor.
Esta información puede cambiar cuando el dispositivo de banda ancha móvil se mueve de una red a otra. Esto incluye cada vez que hay un cambio de MBN_REGISTER_STATE_HOME a MBN_REGISTER_STATE_SEARCHING en el estado de registro de red. Esto también ocurre cuando hay un cambio en la red registrada, como cuando una red mueve su registro de un proveedor a otro. Después de estos cambios, el servicio de banda ancha móvil llamará al método OnRegisterStateChange de IMbnRegistrationEvents. Cuando esto sucede, la aplicación debe llamar a GetProviderID.
Para el error recuperable E_MBN_PIN_REQUIRED, el servicio de banda ancha móvil volverá a intentar capturar esta información del dispositivo cuando se supere la condición de error (cuando se escribe un PIN). Después, el servicio de banda ancha móvil llamará al método OnPacketServiceStateChange de IMbnRegistrationEvents.
Requisitos
| Cliente mínimo compatible | Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | mbnapi.h |