PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN fonction de rappel (winbio_adapter.h)

Article
03/03/2024

Appelé par l’infrastructure biométrique Windows pour définir les stratégies étendues d’anti-usurpation par défaut et par utilisateur utilisées par l’adaptateur moteur.

Syntaxe

PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN PibioEngineSetAccountPolicyFn;

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

Paramètres

[in, out] Pipeline

Pointeur vers la structure WINBIO_PIPELINE associée à l’unité biométrique effectuant l’opération.

[in] PolicyItemArray

Adresse d’un tableau de structures WINBIO_ACCOUNT_POLICY , que la routine doit utiliser pour mettre à jour les stratégies qu’elle applique aux identités qu’elle détecte.

[in] PolicyItemCount

Nombre d’éléments dans le tableau pointé vers le paramètre PolicyItemArray .

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Si la fonction échoue, elle doit retourner l’une des valeurs HRESULT suivantes pour indiquer l’erreur.

Code de retour	Description
E_some_error	Les erreurs retournées par la méthode sont consignées mais ignorées.

Remarques

Cette méthode est appelée chaque fois que l’unité biométrique est activée.

Cette méthode s’exécute dans le contexte du même thread qui a activé l’unité biométrique et qui a traité toutes les autres demandes pour l’unité.

Le champ Identity.Type du premier élément du PolicyItemArray sera toujours WINBIO_ID_TYPE_WILDCARD. Cela indique que l’élément de stratégie contient une valeur AntiSpoofBehavior par défaut qui doit être appliquée à tout compte d’utilisateur qui n’est pas explicitement répertorié dans le reste du tableau.

Si PolicyItemArray contient plusieurs éléments, le champ Identity.Type des éléments restants sera WINBIO_ID_TYPE_WILDCARD, et le champ Identity.Value.AccountSid.Data contiendra le SID d’un compte d’utilisateur qui nécessite le comportement de stratégie antispoof spécifié dans le champ AntiSpoofBehavior de l’élément array.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	winbio_adapter.h (include Winbio_adapter.h)

Partager via