Win32 API 日本語リファレンス
ホーム › Devices.BiometricFramework › PWINBIO_ASYNC_COMPLETION_CALLBACK

PWINBIO_ASYNC_COMPLETION_CALLBACK

コールバック

シグネチャ

void PWINBIO_ASYNC_COMPLETION_CALLBACK(
    WINBIO_ASYNC_RESULT* AsyncResult
);

パラメーター

フィールド型説明
AsyncResultWINBIO_ASYNC_RESULT*完了した操作に関する情報を格納する WINBIO_ASYNC_RESULT 構造体へのポインター。この構造体は Windows Biometric Framework によって作成されます。構造体を解放するには WinBioFree を呼び出す必要があります。

公式ドキュメント

非同期操作が完了したことをクライアントアプリケーションに通知するために、Windows Biometric Framework から呼び出されます。このコールバックはクライアントアプリケーションが定義し、Windows Biometric Framework が呼び出します。

解説(Remarks)

WinBioAsyncOpenSession 関数または WinBioAsyncOpenFramework 関数を使用してバイオメトリックセッションを開き、いずれかの関数の NotificationMethod パラメーターに WINBIO_ASYNC_NOTIFY_CALLBACK を設定する場合は、このコールバックを作成する必要があります。

重要 WINBIO_ASYNC_RESULT 構造体は Windows Biometric Framework によって内部的に割り当てられます。そのため、使い終えたら WinBioFree を呼び出して割り当て済みメモリを解放し、リークを防いでください。この呼び出しは入れ子になったすべてのデータ構造も解放するため、WINBIO_ASYNC_RESULT 構造体で返されたポインターのコピーを保持しないでください。入れ子の構造体で返されたデータを保存したい場合は、WinBioFree を呼び出す前にそのデータの独自のコピーを作成してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)