Método IMbnPinManager::GetPinState (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 estado de PIN actual del dispositivo.

Sintaxis

HRESULT GetPinState(
  [out] ULONG *requestID
);

Parámetros

[out] requestID

Puntero al identificador de solicitud establecido por el servicio de banda ancha móvil para esta solicitud asincrónica. La respuesta contendrá el mismo identificador de solicitud.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	El servicio de banda ancha móvil no se está ejecutando en este sistema.
E_HANDLE	La interfaz no es válida, lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	La interfaz no es válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.

Comentarios

El método GetPinState inicia una solicitud asincrónica para el estado de PIN del dispositivo. El estado del PIN indica si es necesario escribir un PIN para que se complete una operación solicitada. También contiene información sobre qué tipo de PIN espera un dispositivo y, opcionalmente, proporciona el número de intentos restantes para escribir un PIN válido.

Este método siempre devuelve el estado de PIN actual del dispositivo. No almacena en caché el estado del PIN en el momento en que se crea este objeto. En su lugar, siempre se pone en contacto con el dispositivo y devuelve el estado de PIN actual del dispositivo.

Puesto que se trata de una operación asincrónica, GetPinState devolverá inmediatamente. Al finalizar la operación, el servicio de banda ancha móvil llamará al método OnGetPinStateComplete de IMbnPinManagerEvents.

Cada vez que una operación devuelve E_MBN_PIN_REQUIRED o el estado listo notificado por el dispositivo es MBN_READY_STATE_DEVICE_LOCKED, una aplicación debe usar este método para consultar el tipo de PIN necesario para desbloquear el dispositivo o sim.

Aunque esta operación está en curso, si el dispositivo de banda ancha móvil se quita del sistema, no se garantiza una llamada al método OnGetPinStateComplete de IMbnPinManagerEvents .

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

IMbnPinManager