Método IMbnPinEvents::OnUnblockComplete (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.
Método de notificación llamado por el servicio de banda ancha móvil para indicar que se ha completado una operación de desbloqueo de PIN
Sintaxis
HRESULT OnUnblockComplete(
[in] IMbnPin *Pin,
[in] MBN_PIN_INFO *pinInfo,
[in] ULONG requestID,
[in] HRESULT status
);
Parámetros
[in] Pin
Interfaz IMbnPin que representa el tipo de PIN.
[in] pinInfo
Puntero a una estructura de MBN_PIN_INFO que contiene información sobre los intentos restantes, en caso de operaciones de error. El contenido de pinInfo solo es significativo cuando el estado es E_MBN_FAILURE.
[in] requestID
Identificador de solicitud establecido por el servicio de banda ancha móvil para identificar la solicitud de desbloqueo del PIN.
[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 |
|---|---|
|
La operación se realizó correctamente. |
|
El dispositivo no admite esta operación. |
|
No se pudo completar la operación. |
|
Se requiere un PIN para que se complete la operación. La aplicación que realiza la llamada puede llamar al método GetPinState de IMbnPinManager para detectar el tipo de PIN esperado. |
|
No hay ninguna SIM en el dispositivo. |
|
Hay una TARJETA SIM incorrecta en el dispositivo. |
Valor devuelto
Este método debe devolver S_OK.
Comentarios
El servicio de banda ancha móvil llama al método OnUnblockComplete para notificar el estado de finalización de una operación de desbloqueo de PIN inicializada por una llamada al método Unblock de IMbnPin.
El contenido de pinInfo solo es significativo cuando el estado es E_MBN_FAILURE. El miembro pinState debe omitirse y el campo pinType se establece en el tipo de PIN de la interfaz IMbnPin actual. Esta estructura contiene los intentos restantes de escribir un PIN válido.
Por ejemplo, si el PIN pasado para cambiar un tipo de PIN es incorrecto, se producirá un error en la operación con un código de estado de E_MBN_FAILURE. En este caso, pinInfo.attemptsRemaining especifica el número de intentos restantes para reintentar esta operación. Si los intentos repetidos con el PIN incorrecto hacen que los intentosRemaining se conviertan en 0, la aplicación puede llamar al método GetPinState de IMbnPinManager para obtener el tipo de PIN necesario.
Si el dispositivo no se desbloquea y si el bloqueo de PUK es de un pin de MBN_PIN_TYPE_PIN1 , también dará como resultado el estado listo del dispositivo cambiando a MBN_READY_STATE_BAD_SIM. Se notificará a la aplicación que realiza la llamada sobre el cambio de ReadyState a través del miembro OnReadyStateChange de IMbnInterfaceEvents.
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 |