PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN Rückruffunktion (winbio_adapter.h)

  • Artikel

Wird vom Windows Biometric Framework aufgerufen, um die erweiterten Standard- und Benutzer-Antispoofingrichtlinien festzulegen, die vom Engine-Adapter verwendet werden.

Syntax

PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN PibioEngineSetAccountPolicyFn;

HRESULT PibioEngineSetAccountPolicyFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_ACCOUNT_POLICY PolicyItemArray,
  [in]      SIZE_T PolicyItemCount
)
{...}

Parameter

[in, out] Pipeline

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

[in] PolicyItemArray

Adresse eines Arrays von WINBIO_ACCOUNT_POLICY Strukturen, die die Routine verwenden sollte, um die Richtlinien zu aktualisieren, die sie auf alle erkannten Identitäten anwendet.

[in] PolicyItemCount

Die Anzahl der Elemente im Array, auf die der PolicyItemArray-Parameter verweist.

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_some_error
Fehler, die von der -Methode zurückgegeben werden, werden protokolliert, aber ignoriert.

Hinweise

Diese Methode wird bei jeder Aktivierung der biometrischen Einheit aufgerufen.

Diese Methode wird im Kontext desselben Threads ausgeführt, der die biometrische Einheit aktiviert und alle anderen Anforderungen für die Einheit verarbeitet hat.

Das Identity.Type-Feld des ersten Elements in PolicyItemArray ist immer WINBIO_ID_TYPE_WILDCARD. Dies gibt an, dass das Richtlinienelement einen AntiSpoofBehavior-Standardwert enthält, der auf jedes Benutzerkonto angewendet werden soll, das nicht explizit im restlichen Array aufgeführt ist.

Wenn das PolicyItemArray mehr als ein Element enthält, wird das Identity.Type-Feld der verbleibenden Elemente WINBIO_ID_TYPE_WILDCARD, und das Identity.Value.AccountSid.Data-Feld enthält die SID eines Benutzerkontos, das das antispoof-Richtlinienverhalten erfordert, das im Feld AntiSpoofBehavior des Arrayelements angegeben ist.

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