Função WinBioEnrollSelect (winbio.h)

Artigo
03/13/2024

Especifica o indivíduo que você deseja registrar quando os dados que representam vários indivíduos estiverem presentes no buffer de exemplo. A partir do Windows 10, build 1607, essa função está disponível para uso com uma imagem móvel.

Sintaxe

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

Parâmetros

[in] SessionHandle

Um valor WINBIO_SESSION_HANDLE que identifica uma sessão biométrica aberta. Abra um identificador de sessão síncrona chamando WinBioOpenSession. Abra um identificador de sessão assíncrona chamando WinBioAsyncOpenSession.

Para registro no reconhecimento facial, use WinBioAsyncOpenSession com o parâmetro PoolType definido como WINBIO_POOL_SYSTEM para obter o identificador.

[in] SelectorValue

Um valor que identifica aquele indivíduo que você deseja selecionar para registro.

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_HANDLE	O identificador de sessão não é válido.
E_INVALIDARG	O parâmetro SelectorValue não pode ser igual a zero.
WINBIO_E_INCORRECT_SESSION_TYPE	O identificador de sessão não corresponde a uma sessão biométrica.

Comentários

Para o registro no reconhecimento facial, você pode encontrar o valor do seletor correto de duas maneiras:

O valor do membro ID de uma das estruturas de WINBIO_PRESENCE enviadas anteriormente.
Os dados produzidos pelas APIs de acompanhamento facial do NUI.

Chame WinBioEnrollSelect para definir o valor do seletor depois de chamar WinBioEnrollBegin para iniciar uma sequência de registro. O valor do seletor se aplica a todas as chamadas WinBioEnrollCapture subsequentes. A configuração de seleção é temporária e é desmarcada automaticamente quando você termina a sequência de registro chamando WinBioEnrollCommit ou WinBioEnrollDiscard.

Se você chamar WinBioEnrollSelect para fatores biométricos que não exigem desambiguação, como impressões digitais, o valor retornado para a função indicará êxito, mas a função ignorará o valor do seletor.

Se você não chamar WinBioEnrollSelect para um fator biométrico que exija que você chame a função, as chamadas subsequentes para WinBioEnrollCapture falharão com o erro WINBIO_E_SELECTION_REQUIRED .

Para Windows 10, os fatores que exigem que você chame WinBioEnrollSelect são características faciais e íris.

Você pode chamar WinBioEnrollSelect usando um identificador de sessão síncrono ou assíncrono. Assim como acontece com outras chamadas para funções da API do Windows Biometric Framework, quando você chama WinBioEnrollSelect com um identificador de sessão assíncrona, o valor retornado indica apenas que os parâmetros de função eram aceitáveis. O sucesso real ou a falha da operação em si será retornado à sua rotina de notificação em uma estrutura WINBIO_ASYNC_RESULT .

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