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 llamado por el servicio de banda ancha móvil para indicar que ha completado una operación de registro establecida.
Sintaxis
HRESULT OnSetRegisterModeComplete(
[in] IMbnRegistration *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Parámetros
[in] newInterface
Puntero a una interfaz IMbnRegistration que representa el dispositivo aplicable. La aplicación de control puede usar esta interfaz para obtener el estado de registro actual del dispositivo.
[in] requestID
Identificador de solicitud asignado por el servicio de banda ancha móvil para realizar un seguimiento de la operación de registro del conjunto.
[in] status
Código de estado que indica el resultado de la operación.
Una aplicación que llama puede esperar uno de los valores posibles.
| Valor |
Significado |
-
S_OK
|
La operación se realizó correctamente.
|
-
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
|
Ya hay una conexión de red activa. No se puede cambiar el modo de registro cuando ya hay una conexión de datos establecida. La aplicación debe desconectar primero la conexión y, a continuación, intentar cambiar el modo de registro. Si el dispositivo ya está en el modo solicitado y está conectado al proveedor solicitado, el código de retorno se S_OK.
|
-
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
|
El dispositivo no admite la operación. Los dispositivos que no admiten el modo de registro solicitado pueden devolverlo. Por ejemplo, un dispositivo SOLICITADA devolverá este error cuando se solicite cambiar al modo de registro manual.
|
-
E_FAIL
|
No se pudo completar la operación. Hay más información disponible en el código de error de red.
|
-
E_INVALIDARG
|
La entrada del modo de registro no válida o el identificador de proveedor proporcionado como entrada es mayor que la longitud máxima de 7 caracteres o la clase de datos proporcionada no es válida. El servicio de banda ancha móvil no enviará la solicitud al dispositivo cuando se proporcionen argumentos no válidos en la entrada.
En el modo de registro manual, esto indica que el proveedor solicitado está prohibido.
|
-
E_MBN_PIN_REQUIRED
|
Se necesita un PIN para que se complete la operación.
|
-
E_MBN_SERVICE_NOT_ACTIVATED
|
La suscripción del servicio de red ha expirado.
|
-
E_MBN_PROVIDER_NOT_VISIBLE
|
Esto solo se produce cuando se cambia al modo de registro manual. El modificador se realiza correctamente, pero el proveedor solicitado no está visible. El dispositivo se registrará en el proveedor solicitado cuando esté visible.
|
Valor devuelto
Este método debe devolver S_OK.
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 |
Consulte también
IMbnRegistrationEvents