Compartir a través de

Método IMbnPinManagerEvents::OnGetPinStateComplete (mbnapi.h)

  • Artículo

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 la finalización de una operación asincrónica desencadenada por una llamada al método GetPinState de IMbnPinManager.

Sintaxis

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parámetros

[in] pinManager

Puntero a una interfaz IMbnPinManager que representa el dispositivo de banda ancha móvil para el que se realizó la operación.

[in] pinInfo

Estructura MBN_PIN_INFO que contiene la información del PIN del dispositivo.

Si pinInfo.pinState se establece en MBN_PIN_STATE_NONE no se espera que el dispositivo escriba ningún PIN.

Si pinInfo.pinState se establece en MBN_PIN_STATE_ENTER , el dispositivo espera que se escriba un PIN y pinInfo.pinType representa el tipo de PIN esperado por el dispositivo.

Si pinInfo.pinState se establece en MBN_PIN_STATE_UNBLOCK , el dispositivo está bloqueado y se debe intentar desbloquear una operación de desbloqueo de PIN. En este caso, pinInfo.pinType representa el tipo de PIN en el que se debe realizar la operación de desbloqueo.

Si pinInfo.pinState se establece en MBN_PIN_STATE_ENTER o MBN_PIN_STATE_UNBLOCK, pinInfo.attemptsRemaining contiene el número de intentos restantes para especificar un PIN o una clave de desbloqueo de PIN (PUK) válida. Si se desconoce el número de intentos restantes, pinInfo.attemptsRemaining se establece en MBN_ATTEMPTS_REMAINING_UNKNOWN.

[in] requestID

Identificador de solicitud asignado por el servicio de banda ancha móvil para identificar esta operación.

[in] status

Estado de finalización de la operación.

Una aplicación que llama puede esperar uno de los valores siguientes.

Valor Significado
S_OK
 La operación se realizó correctamente.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 El dispositivo no admite operaciones de PIN.
E_MBN_SIM_NOT_INSERTED
 No se pudo completar la operación porque una SIM no está en el dispositivo.
E_MBN_BAD_SIM
 No se pudo completar la operación porque se detectó una SIM incorrecta en el dispositivo.

Valor devuelto

Este método debe devolver S_OK.

Comentarios

El servicio Mobile Broadband llama a este método para notificar a una aplicación la finalización de una operación asincrónica desencadenada por una llamada al método GetPinState de IMbnPinManager.
Al finalizar correctamente, pinInfo contiene información sobre el PIN siguiente esperado por el dispositivo.

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

IMbnPinManagerEvents