Compartilhar via

Função WinBioGetEnrolledFactors (winbio.h)

  • Artigo

Obtém informações sobre os registros biométricos que o usuário especificado tem no computador. Os registros biométricos incluem registros para reconhecimento facial, digitalização de impressão digital, verificação de íris e assim por diante.

Sintaxe

HRESULT WinBioGetEnrolledFactors(
  [in]  WINBIO_IDENTITY       *AccountOwner,
  [out] WINBIO_BIOMETRIC_TYPE *EnrolledFactors
);

Parâmetros

[in] AccountOwner

Uma estrutura WINBIO_IDENTITY para o usuário cujos registros biométricos você deseja obter. Por exemplo:

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;

// Move an account SID into identity.Value.AccountSid.Data.
// For example, CopySid(...)

Para ver os registros de cada usuário no computador, especifique o tipo de identidade WINBIO_ID_TYPE_WILDCARD para a estrutura WINBIO_IDENTITY especificada para o parâmetro AccountOwner . Por exemplo:

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_WILDCARD;

[out] EnrolledFactors

Um conjunto de sinalizadores de WINBIO_BIOMETRIC_TYPE que indicam os registros biométricos que o usuário especificado tem no computador. Um valor 0 indica que o usuário não tem registros biométricos.

Esses registros representam apenas registros de pool do sistema, como registros que você pode usar para autenticar um usuário para entrar, desbloquear e assim por diante. Esse valor não inclui registros de pool privado.

Se você especificar o tipo de identidade curinga para a estrutura WINBIO_IDENTITY usada para o parâmetro AccountOwner , esse conjunto de sinalizadores representará o conjunto combinado de registros para todos os usuários com contas no computador.

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Código de retorno Descrição
E_POINTER
 Os parâmetros AccountOwner e EnrolledFactors não podem ser NULL.
E_INVALIDARG
 O membro Type da estrutura WINBIO_IDENTITY especificada pelo parâmetro AccountOnwer não foi WINBIO_ID_TYPE_SID ou WINBIO_ID_TYPE_WILDCARD ou o membro AccountSid da estrutura WINBIO_IDENTITY não era válido.

Comentários

WinBioGetEnrolledFactors não requer um identificador de sessão biométrica e não ativa o serviço biométrico. Consequentemente, WinBioGetEnrolledFactors é executado rapidamente e é útil quando seu código precisa tomar decisões rápidas sobre como proceder quando o tempo é crítico para o conjunto de operações que você precisa executar.

O WinBioGetEnrolledFactors fornece aos provedores de credenciais uma maneira de personalizar a interface do usuário adequadamente. Por exemplo, a tela de logon chama WinBioGetEnrolledFactors para determinar se deseja exibir a opção de logon com uma impressão digital.

Exemplos

WINBIO_BIOMETRIC_TYPE enrolledFactors = WINBIO_NO_TYPE_AVAILABLE;

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;

// Move an account SID into identity.Value.AccountSid.Data.
// e.g., CopySid(...)

HRESULT hr = WinBioGetEnrolledFactors(&identity, &enrolledFactors);

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbio.h
Biblioteca Winbio.lib
DLL Winbio.dll

Confira também

WINBIO_BIOMETRIC_TYPE

WINBIO_IDENTITY