PIBIO_ENGINE_SET_ENROLLMENT_SELECTOR_FN Rückruffunktion (winbio_adapter.h)

  • Artikel

Wird vom Windows Biometric Framework aufgerufen, um dem Engine-Adapter mitzuteilen, welche Person für den aktuellen Registrierungsvorgang nachverfolgt werden soll.

Syntax

PIBIO_ENGINE_SET_ENROLLMENT_SELECTOR_FN PibioEngineSetEnrollmentSelectorFn;

HRESULT PibioEngineSetEnrollmentSelectorFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      ULONGLONG SelectorValue
)
{...}

Parameter

[in, out] Pipeline

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

[in] SelectorValue

Der zu verwendende Registrierungsauswahlwert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Wenn die Funktion fehlschlägt, muss sie einen der folgenden HRESULT-Werte zurückgeben, um den Fehler anzugeben.

Rückgabecode Beschreibung
E_POINTER
 Der Pipelineparameter darf nicht NULL sein.

Hinweise

Bei einigen biometrischen Faktoren (z. B. WINBIO_TYPE_FACIAL_FEATURES) können mehrere Personen gleichzeitig im Kamerarahmen sein. Während eines Registrierungsvorgangs muss die Registrierungsanwendung eine bestimmte Person auswählen, die registriert werden soll. Die Registrierungsanwendung ruft dazu die WinBioEnrollSelect-Funktion auf. Das Windows Biometric Framework ruft dann die EngineAdapterSetEnrollmentSelector-Funktion des Moduladapters mit diesen Informationen auf.

Der Engine-Adapter sollte diesen Wert speichern und verwenden, um die richtige Person während der Registrierung nachzuverfolgen.

Anforderungen

   
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 (Winbio_adapter.h einschließen)