PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN コールバック関数 (winbio_adapter.h)

  • [アーティクル]

Windows 生体認証フレームワークによって呼び出され、エンジン アダプターによって使用される拡張既定およびユーザーごとのアンチスプーピング ポリシーを設定します。

構文

PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN PibioEngineSetAccountPolicyFn;

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

パラメーター

[in, out] Pipeline

操作を実行する生体認証ユニットに関連付けられている WINBIO_PIPELINE 構造体へのポインター。

[in] PolicyItemArray

WINBIO_ACCOUNT_POLICY構造体の配列のアドレス。ルーチンは、検出したすべての ID に適用されているポリシーを更新するために使用する必要があります。

[in] PolicyItemCount

PolicyItemArray パラメーターが指す配列内の要素の数。

戻り値

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

リターン コード 説明
E_some_error
メソッドによって返されるエラーはログに記録されますが、無視されます。

注釈

このメソッドは、生体認証ユニットがアクティブ化されるたびに呼び出されます。

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

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

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

要件

要件 値
サポートされている最小のクライアント Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winbio_adapter.h (Winbio_adapter.h を含む)