Função WbioQueryEngineInterface (winbio_adapter.h)

  • Artigo

Recupera um ponteiro para a estrutura WINBIO_ENGINE_INTERFACE para o adaptador do mecanismo.

Sintaxe

HRESULT WbioQueryEngineInterface(
  [out] PWINBIO_ENGINE_INTERFACE *EngineInterface
);

Parâmetros

[out] EngineInterface

Endereço de uma variável que recebe um ponteiro para a estrutura WINBIO_ENGINE_INTERFACE .

Valor retornado

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela deverá retornar um dos seguintes valores HRESULT para indicar o erro.

Código de retorno Descrição
E_POINTER
 O parâmetro EngineInterface não pode ser NULL.

Comentários

A Estrutura Biométrica do Windows chama essa função depois de carregar uma DLL do adaptador do mecanismo na memória. Cada DLL do adaptador de mecanismo deve, portanto, implementar e exportar a função WbioQueryEngineInterface . O nome da função diferencia maiúsculas de minúsculas e sua ortografia e assinatura devem corresponder exatamente à fornecida na seção Sintaxe.

Para ficar visível para o Windows Biometric Framework, a função WbioQueryEngineInterface deve ser nomeada na seção EXPORTS do arquivo de comando do vinculador de definição de exportação para a DLL.

Exemplos

O pseudocódigo a seguir mostra uma possível implementação dessa função.

HRESULT
WINAPI
WbioQueryEngineInterface(
    __out PWINBIO_ENGINE_INTERFACE *EngineInterface)
{
    // g_EngineInterface is a global variable.
    *EngineInterface = &g_EngineInterface;
    return S_OK;
}

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbio_adapter.h (inclua Winbio_adapter.h)

Confira também

Funções de plug-in