PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN Rückruffunktion (winbio_adapter.h)

  • Artikel

Wird vom Windows Biometric Framework aufgerufen, wenn eine Clientanwendung die eigenschaft WINBIO_PROPERTY_EXTENDED_ENROLLMENT_STATUS abfragt.

Syntax

PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN PibioEngineQueryExtendedEnrollmentStatusFn;

HRESULT PibioEngineQueryExtendedEnrollmentStatusFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_EXTENDED_ENROLLMENT_STATUS EnrollmentStatus,
  [in]      SIZE_T EnrollmentStatusSize
)
{...}

Parameter

[in, out] Pipeline

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

[out] EnrollmentStatus

Zeiger auf die WINBIO_EXTENDED_ENROLLMENT_STATUS-Struktur, die die erweiterte Registrierung status von dieser Funktion zurückgegebenen Informationen enthält.

[in] EnrollmentStatusSize

Die angegebene Größe in Bytes der erweiterten Registrierung status Informationen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. 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.
E_INVALIDARG
Der Parameter EnrollmentStatusSize gibt an, dass der Ausgabepuffer zu klein ist.

Hinweise

Registrierungsanwendungen können nach jedem Aufruf der WinBioEnrollCapture-Funktion erweiterte Registrierung status Informationen anfordern.

Wenn die biometrische Einheit derzeit keine Registrierungsvorlage ist, wenn diese Routine aufgerufen wird, sollte der Moduladapter das Feld EnrollmentStatus.TemplateStatus auf WINBIO_E_INVALID_OPERATION festlegen und S_OK als Wert der Funktion zurückgeben.

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)