Método IMbnPin::Unblock (mbnapi.h)
Importante
A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Desbloqueia um PIN bloqueado.
Sintaxe
HRESULT Unblock(
[in] LPCWSTR puk,
[in] LPCWSTR newPin,
[out] ULONG *requestID
);
Parâmetros
[in] puk
O valor da chave de desbloqueio de senha (PUK) para esse tipo de PIN.
[in] newPin
Um novo PIN a ser definido para esse tipo de PIN.
[out] requestID
Uma ID de solicitação definida pelo serviço de Banda Larga Móvel para identificar essa solicitação assíncrona.
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
O serviço de Banda Larga Móvel não está em execução neste sistema. |
|
Interface inválida. O dispositivo de Banda Larga Móvel provavelmente foi removido do sistema. |
|
Interface inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
Esse método não é permitido para chamar privilégios de processo. |
Comentários
O método Unblock desbloqueia o PIN para o tipo de pino inserindo o PUK e define um novo PIN. A propriedade PinType desse IMbnPin representa o tipo de PIN que está sendo alterado.
Esta é uma operação assíncrona. Se o método retornar com êxito, após a conclusão da operação, o serviço de Banda Larga Móvel chamará o método OnUnblockComplete de IMbnPinEvents.
Sempre que o método GetPinState de IMbnPinManager resulta com o estado pin atual definido como MBN_PIN_STATE_UNBLOCK, o aplicativo deve usar Unblock no tipo PIN que é retornado em PinInfo.pinType passado pelo método OnGetPinStateComplete de IMbnPinManagerEvents.
Invocar esse método requer privilégios de administrador.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |