Compartilhar via

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

  • Artigo

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 a conclusão de uma operação assíncrona disparada por uma chamada para o método GetPinState de IMbnPinManager.

Sintaxe

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

Parâmetros

[in] pinManager

Ponteiro para uma interface IMbnPinManager que representa o dispositivo de Banda Larga Móvel para o qual a operação foi executada.

[in] pinInfo

Uma estrutura MBN_PIN_INFO que contém as informações de PIN do dispositivo.

Se pinInfo.pinState estiver definido como MBN_PIN_STATE_NONE nenhum PIN deverá ser inserido pelo dispositivo.

Se pinInfo.pinState estiver definido como MBN_PIN_STATE_ENTER , o dispositivo espera que um PIN seja inserido e pinInfo.pinType represente o tipo de PIN esperado pelo dispositivo.

Se pinInfo.pinState estiver definido como MBN_PIN_STATE_UNBLOCK , o dispositivo será bloqueado por PIN e uma operação de desbloqueio de PIN deverá ser tentada para desbloquear o dispositivo. Nesse caso, pinInfo.pinType representa o tipo pin no qual a operação de desbloqueio deve ser executada.

Se pinInfo.pinState estiver definido como MBN_PIN_STATE_ENTER ou MBN_PIN_STATE_UNBLOCK, pinInfo.attemptsRemaining conterá o número de tentativas restantes para inserir um PIN válido ou uma chave de desbloqueio de PIN (PUK). Se o número de tentativas restantes for desconhecido, pinInfo.attemptsRemaining será definido como MBN_ATTEMPTS_REMAINING_UNKNOWN.

[in] requestID

A ID de solicitação atribuída pelo serviço de Banda Larga Móvel para identificar essa operação.

[in] status

O status de conclusão da operação.

Um aplicativo de chamada pode esperar um dos valores a seguir.

Valor Significado
S_OK
 A operação foi bem-sucedida.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 O dispositivo não dá suporte a operações de PIN.
E_MBN_SIM_NOT_INSERTED
 A operação não pôde ser concluída porque um SIM não está no dispositivo.
E_MBN_BAD_SIM
 A operação não pôde ser concluída porque um SIM inválido foi detectado no dispositivo.

Valor retornado

Esse método deve retornar S_OK.

Comentários

Esse método é chamado pelo serviço de Banda Larga Móvel para notificar uma aplicação da conclusão de uma operação assíncrona disparada por uma chamada para o método GetPinState de IMbnPinManager.
Após a conclusão bem-sucedida, pinInfo contém informações sobre o PIN esperado pelo dispositivo.

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

Confira também

IMbnPinManagerEvents