Share via

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

  • [アーティクル]

生体認証エンジン コンポーネントの機能と制限を決定するために、Windows 生体認証フレームワークによって呼び出されます。

構文

PIBIO_ENGINE_QUERY_EXTENDED_INFO_FN PibioEngineQueryExtendedInfoFn;

HRESULT PibioEngineQueryExtendedInfoFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_EXTENDED_ENGINE_INFO EngineInfo,
  [in]      SIZE_T EngineInfoSize
)
{...}

パラメーター

[in, out] Pipeline

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

[out] EngineInfo

この関数によって返されるエンジン情報を含む WINBIO_EXTENDED_ENGINE_INFO 構造体へのポインター。

[in] EngineInfoSize

エンジン情報の指定されたサイズ (バイト単位)。

戻り値

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

リターン コード 説明
E_POINTER
 Pipeline パラメーターと EngineInfo パラメーターを NULL にすることはできません。
E_INVALIDARG
EngineInfoSize 値は、エンジン情報を返すために必要なサイズよりも小さくなります。

注釈

このメソッドは、生体認証ユニットの構成中に 1 回呼び出されます。

また、クライアント アプリケーションが WinBioGetProperty 関数を使用して WINBIO_PROPERTY_EXTENDED_ENGINE_INFO プロパティの値を照会する場合にも呼び出されます。

要件

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