Método IMbnPinManager::GetPinState (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.

Obtém o estado atual do PIN do dispositivo.

Sintaxe

HRESULT GetPinState(
  [out] ULONG *requestID
);

Parâmetros

[out] requestID

Um ponteiro para a ID de solicitação definida pelo serviço de Banda Larga Móvel para essa solicitação assíncrona. A resposta conterá a mesma ID de solicitação.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	O serviço de Banda Larga Móvel não está em execução neste sistema.
E_HANDLE	A interface é inválida, provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema.

Comentários

O método GetPinState inicia uma solicitação assíncrona para o estado do PIN do dispositivo. O estado do PIN indica se um PIN precisa ser inserido para que uma operação solicitada seja concluída. Ele também contém informações sobre qual tipo de PIN é esperado por um dispositivo e, opcionalmente, fornece o número de tentativas restantes para inserir um PIN válido.

Esse método sempre retorna o estado atual do PIN do dispositivo. Ele não armazena em cache o estado do PIN no momento em que esse objeto é criado. Em vez disso, ele sempre entra em contato com o dispositivo e retorna o estado atual do PIN do dispositivo.

Como essa é uma operação assíncrona, GetPinState retornará imediatamente. Após a conclusão da operação, o serviço de Banda Larga Móvel chamará o método OnGetPinStateComplete de IMbnPinManagerEvents.

Sempre que uma operação retorna E_MBN_PIN_REQUIRED ou o estado pronto relatado pelo dispositivo é MBN_READY_STATE_DEVICE_LOCKED, um aplicativo deve usar esse método para consultar o tipo de PIN necessário para desbloquear o dispositivo ou SIM.

Enquanto essa operação estiver em andamento, se o dispositivo de Banda Larga Móvel for removido do sistema, uma chamada para o método OnGetPinStateComplete de IMbnPinManagerEvents não será garantida.

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

IMbnPinManager