Método IMbnPinEvents::OnUnblockComplete (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.
Método de notificação chamado pelo serviço de Banda Larga Móvel para indicar que uma operação de desbloqueio de PIN foi concluída
Sintaxe
HRESULT OnUnblockComplete(
[in] IMbnPin *Pin,
[in] MBN_PIN_INFO *pinInfo,
[in] ULONG requestID,
[in] HRESULT status
);
Parâmetros
[in] Pin
Uma interface IMbnPin que representa o tipo de PIN.
[in] pinInfo
Um ponteiro para uma estrutura MBN_PIN_INFO que contém informações sobre as tentativas restantes, em caso de operações de falha. O conteúdo de pinInfo só é significativo quando status é E_MBN_FAILURE.
[in] requestID
Uma ID de solicitação definida pelo serviço de Banda Larga Móvel para identificar a solicitação de desbloqueio de PIN.
[in] status
Um código status que indica o resultado da operação.
Um aplicativo de chamada pode esperar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
A operação foi bem-sucedida. |
|
O dispositivo não dá suporte a essa operação. |
|
Não foi possível concluir a operação. |
|
Um PIN é necessário para que a operação seja concluída. O aplicativo de chamada pode chamar o método GetPinState de IMbnPinManager para descobrir o tipo de PIN esperado. |
|
Não há nenhum SIM no dispositivo. |
|
Há um SIM inválido no dispositivo. |
Valor retornado
Esse método deve retornar S_OK.
Comentários
O método OnUnblockComplete é chamado pelo serviço de Banda Larga Móvel para relatar o status de conclusão de uma operação de desbloqueio de PIN inicializada por uma chamada para o método Unblock de IMbnPin.
O conteúdo de pinInfo só é significativo quando status é E_MBN_FAILURE. O membro pinState deve ser ignorado e o campo pinType é definido como o tipo PIN da interface IMbnPin atual. Essa estrutura contém as tentativas restantes de inserir um PIN válido.
Por exemplo, se o PIN passado para alterar um tipo de PIN estiver incorreto, a operação falhará com um código status de E_MBN_FAILURE. Nesse caso, pinInfo.attemptsRemaining especifica o número de tentativas restantes para repetir essa operação. Se tentativas repetidas com o PIN errado fizerem com que attemptsRemaining se torne 0, o aplicativo poderá chamar o método GetPinState de IMbnPinManager para obter o tipo de PIN necessário.
Se o dispositivo não for desbloqueado e se o bloqueio PUK for de um pino de MBN_PIN_TYPE_PIN1 , isso também resultará no estado pronto do dispositivo mudando para MBN_READY_STATE_BAD_SIM. O aplicativo de chamada será notificado sobre a alteração de ReadyState por meio do membro OnReadyStateChange de IMbnInterfaceEvents.
Requisitos
| 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 |