Método IMbnPinManager::GetPinList (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 uma lista de diferentes tipos de PIN compatíveis com o dispositivo.

Sintaxe

HRESULT GetPinList(
  [out, retval] SAFEARRAY **pinList
);

Parâmetros

[out, retval] pinList

Um ponteiro para uma lista de valores de MBN_PIN_TYPE que representam os tipos de PIN compatíveis com o dispositivo. Quando GetPinList retorna algo diferente de S_OK, pinList é NULL, caso contrário, o aplicativo de chamada deve liberar a memória alocada chamando SafeArrayDestroy.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_PENDING	Os tipos de PIN não estão disponíveis. O serviço de Banda Larga Móvel está atualmente investigando o dispositivo para obter as informações. Quando os tipos de PIN estiverem disponíveis, o serviço de Banda Larga Móvel chamará o método OnPinListAvailable de IMbnPinManagerEvents.
E_MBN_PIN_REQUIRED	O dispositivo requer que um PIN seja inserido para essa operação.
E_MBN_SIM_NOT_INSERTED	O SIM não está inserido.
E_MBN_BAD_SIM	Um SIM inválido é inserido no dispositivo.

Comentários

Nos erros recuperáveis E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, o serviço de Banda Larga Móvel tentará recuperar essas informações do dispositivo quando a condição de erro terminar. Enquanto estiver recuperando essas informações, a chamada GetPinList retornará E_PENDING. Depois que a operação de recuperação for concluída, o serviço de Banda Larga Móvel chamará o método OnPinListAvailable de IMbnPinManagerEvents.

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

Confira também

IMbnPinManager