ホーム › Devices.BiometricFramework › PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN

PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN

コールバック

シグネチャ

HRESULT PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN(
    WINBIO_PIPELINE* Pipeline,
    WINBIO_ACCOUNT_POLICY* PolicyItemArray,
    UINT_PTR PolicyItemCount
);

パラメーター

フィールド	型	説明
Pipeline	WINBIO_PIPELINE*	操作を実行するバイオメトリックユニットに関連付けられた WINBIO_PIPELINE 構造体へのポインターです。
PolicyItemArray	WINBIO_ACCOUNT_POLICY*	WINBIO_ACCOUNT_POLICY 構造体の配列のアドレスです。ルーチンはこの配列を使用して、検出した ID に適用するポリシーを更新します。
PolicyItemCount	UINT_PTR	PolicyItemArray パラメーターが指す配列の要素数です。

公式ドキュメント

エンジンアダプターが使用する、拡張された既定のアンチスプーフィングポリシーおよびユーザーごとのアンチスプーフィングポリシーを設定するために、Windows Biometric Framework によって呼び出されます。

戻り値

関数が成功した場合は S_OK を返します。関数が失敗した場合は、エラーを示すために次の HRESULT 値のいずれかを返す必要があります。

戻り値	説明
E_some_error	このメソッドが返すエラーはログに記録されますが、無視されます。

解説(Remarks)

このメソッドは、バイオメトリックユニットがアクティブ化されるたびに呼び出されます。

このメソッドは、バイオメトリックユニットをアクティブ化し、そのユニットに対する他のすべての要求を処理したスレッドと同じスレッドのコンテキストで実行されます。

PolicyItemArray の最初の要素の Identity.Type フィールドは、常に WINBIO_ID_TYPE_WILDCARD になります。これは、そのポリシー項目が既定の AntiSpoofBehavior 値を保持していることを示し、この値は配列の残りの要素に明示的に列挙されていないすべてのユーザーアカウントに適用されます。

PolicyItemArray に複数の要素が含まれる場合、残りの項目の Identity.Type フィールドは WINBIO_ID_TYPE_WILDCARD となり、Identity.Value.AccountSid.Data フィールドには、その配列要素の AntiSpoofBehavior フィールドで指定されたアンチスプーフィングポリシーの動作を必要とするユーザーアカウントの SID が格納されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)