Freigeben über


PIBIO_ENGINE_CREATE_KEY_FN Rückruffunktion (winbio_adapter.h)

Wird vom Windows Biometric Framework aufgerufen, um einen HMAC-Schlüssel auf den Sensor zu übertragen. Der zurückgegebene Schlüsselbezeichner wird zurück an die biometrische Einheit übergeben, wenn das Framework EngineAdapterIdentifyFeatureSetSecure aufruft.

Syntax

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
)
{...}

Parameter

Pipeline

Zeiger auf eine WINBIO_PIPELINE Struktur, die der biometrischen Einheit zugeordnet ist, die den Vorgang ausführt.

Key

Zeiger auf einen Puffer, der den HMAC-Schlüssel enthält.

KeySize

Größe des durch den Key-Parameter angegebenen Puffers in Bytes.

KeyIdentifier

Zeiger auf einen Puffer, der einen Schlüsselbezeichner empfängt. Das Format des Puffers ist vom Anbieter definiert.

KeyIdentifierSize

Größe des Puffers, der durch den KeyIdentifier-Parameter angegeben wird, in Bytes.

ResultSize

Zeiger auf eine Variable, die die Größe der Daten in Bytes empfängt, die in den vom KeyIdentifier-Parameter angegebenen Puffer geschrieben werden.

Rückgabewert

Wenn der KeyIdentifier-Puffer zu klein ist, muss WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL zurückgegeben werden, und die erforderliche Größe muss in ResultSize geschrieben werden. Das Framework ruft die API erneut mit einem größeren Puffer auf. Wenn der Sensor den Schlüssel nicht erstellen kann, muss WINBIO_E_KEY_CREATION_FAILED zurückgegeben werden.

Hinweise

Nur ein einzelner Schlüssel wird zu jeder Zeit verwendet. Wenn EngineAdapterCreateKey aufgerufen wird, wenn das Modul Kenntnis von einem bereits vorhandenen Schlüssel hat, muss der bereits vorhandene Schlüssel mit dem neuen Schlüssel überschrieben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbio_adapter.h (einschließlich Winbio_adapter.h)