Método IMbnPin::Unblock (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.

Desbloquea un PIN bloqueado.

Sintaxis

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

Parámetros

[in] puk

Valor de clave de desbloqueo de contraseña (PUK) para este tipo de PIN.

[in] newPin

Nuevo PIN que se va a establecer para este tipo de PIN.

[out] requestID

Identificador de solicitud establecido por el servicio de banda ancha móvil para identificar esta solicitud asincrónica.

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	Interfaz no válida. Es probable que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interfaz no válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
E_ACCESSDENIED	Este método no se permite para llamar a privilegios de proceso.

Comentarios

El método Unblock desbloquea el PIN para el tipo de pin escribiendo la PUK y establece un nuevo PIN. La propiedad PinType de este IMbnPin representa el tipo de PIN que se está cambiando.

Se trata de una operación asincrónica, Si el método se devuelve correctamente, después de completar la operación, el servicio de banda ancha móvil llamará al método OnUnblockComplete de IMbnPinEvents.

Cada vez que el método GetPinState de IMbnPinManager da como resultado el estado de PIN actual establecido en MBN_PIN_STATE_UNBLOCK, la aplicación debe usar Unblock en el tipo de PIN que se devuelve en PinInfo.pinType pasado por el método OnGetPinStateComplete de IMbnPinManagerEvents.

La invocación de este método requiere privilegios de administrador.

Requisitos

Requisito	Value
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

IMbnPin