função de retorno de chamada PIBIO_ENGINE_CREATE_KEY_FN (winbio_adapter.h)

Chamado pela Estrutura Biométrica do Windows para enviar por push uma chave HMAC para o sensor. O identificador de chave retornado será passado de volta para a unidade biométrica quando a estrutura chamar EngineAdapterIdentifyFeatureSetSecure.

Sintaxe

PIBIO_ENGINE_CREATE_KEY_FN PibioEngineCreateKeyFn;

HRESULT PibioEngineCreateKeyFn(
  PWINBIO_PIPELINE Pipeline,
  const UCHAR *Key,
  SIZE_T KeySize,
  PUCHAR KeyIdentifier,
  SIZE_T KeyIdentifierSize,
  PSIZE_T ResultSize
)
{...}

Parâmetros

Pipeline

Ponteiro para uma estrutura WINBIO_PIPELINE associada à unidade biométrica que executa a operação.

Key

Ponteiro para um buffer que contém a chave HMAC.

KeySize

Tamanho, em bytes, do buffer especificado pelo parâmetro Key .

KeyIdentifier

Ponteiro para um buffer que recebe um identificador de chave. O formato do buffer é definido pelo fornecedor.

KeyIdentifierSize

Tamanho, em bytes, do buffer especificado pelo parâmetro KeyIdentifier .

ResultSize

Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados gravados no buffer especificado pelo parâmetro KeyIdentifier .

Retornar valor

Se o buffer KeyIdentifier for muito pequeno, WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL deverá ser retornado e o tamanho necessário deverá ser gravado em ResultSize. A estrutura chamará a API novamente com um buffer maior. Se o sensor não puder criar a chave, WINBIO_E_KEY_CREATION_FAILED deverá ser retornado.

Comentários

Somente uma única chave estará em uso a qualquer momento. Se EngineAdapterCreateKey for chamado quando o mecanismo tiver conhecimento de uma chave preexistente, a chave preexistente deverá ser substituída pela nova.

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_adapter.h (inclua Winbio_adapter.h)