PIBIO_ENGINE_CREATE_KEY_FN 콜백 함수(winbio_adapter.h)

HMAC 키를 센서에 푸시하기 위해 Windows 생체 인식 프레임워크에서 호출됩니다. 반환된 키 식별자는 프레임워크가 EngineAdapterIdentifyFeatureSetSecure를 호출할 때 생체 인식 단위로 다시 전달됩니다.

구문

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

매개 변수

Pipeline

작업을 수행하는 생체 인식 단위와 연결된 WINBIO_PIPELINE 구조체에 대한 포인터입니다.

Key

HMAC 키를 포함하는 버퍼에 대한 포인터입니다.

KeySize

Key 매개 변수로 지정된 버퍼의 크기(바이트)입니다.

KeyIdentifier

키 식별자를 수신하는 버퍼에 대한 포인터입니다. 버퍼의 형식은 공급업체에서 정의됩니다.

KeyIdentifierSize

KeyIdentifier 매개 변수에 지정된 버퍼의 크기(바이트)입니다.

ResultSize

KeyIdentifier 매개 변수로 지정된 버퍼에 기록된 데이터의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

반환 값

KeyIdentifier 버퍼가 너무 작으면 WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL 반환되어야 하며 필요한 크기를 ResultSize에 기록해야 합니다. 프레임워크는 더 큰 버퍼를 사용하여 API를 다시 호출합니다. 센서가 키를 만들 수 없는 경우 WINBIO_E_KEY_CREATION_FAILED 반환해야 합니다.

설명

한 번에 하나의 키만 사용됩니다. 엔진에 기존 키에 대한 지식이 있을 때 EngineAdapterCreateKey 가 호출되는 경우 기존 키를 새 키로 덮어써야 합니다.

요구 사항