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 |
|---|---|
|
O método foi concluído com sucesso. |
|
O serviço de Banda Larga Móvel não está em execução neste sistema. |
|
A interface é inválida, provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
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 |