PWINBIO_ASYNC_COMPLETION_CALLBACK callback function (winbio.h)

Article
02/22/2024

Called by the Windows Biometric Framework to notify the client application that an asynchronous operation has completed. The callback is defined by the client application and called by the Windows Biometric Framework.

Syntax

PWINBIO_ASYNC_COMPLETION_CALLBACK PwinbioAsyncCompletionCallback;

void PwinbioAsyncCompletionCallback(
  [in] PWINBIO_ASYNC_RESULT AsyncResult
)
{...}

Parameters

[in] AsyncResult

Pointer to a WINBIO_ASYNC_RESULT structure that contains information about the completed operation. The structure is created by the Windows Biometric Framework. You must call WinBioFree to release the structure.

Return value

None

Remarks

You must create this callback if you open a biometric session by using the WinBioAsyncOpenSession function or the WinBioAsyncOpenFramework function and you set WINBIO_ASYNC_NOTIFY_CALLBACK in the NotificationMethod parameter of either function.

Important The WINBIO_ASYNC_RESULT structure is allocated internally by the Windows Biometric Framework. Therefore, when you are through using it, call WinBioFree to release the allocated memory and avoid leaks. Because this also releases all nested data structures, you should not keep a copy of any pointers returned in the WINBIO_ASYNC_RESULT structure. If you want to save any data returned in a nested structure, make a private copy of that data before calling WinBioFree.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	winbio.h