PWINBIO_ASYNC_COMPLETION_CALLBACK function pointer

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


typedef VOID ( CALLBACK *PWINBIO_ASYNC_COMPLETION_CALLBACK)(
  _In_  PWINBIO_ASYNC_RESULT AsyncResult
);

Parameters

AsyncResult [in]

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

Do not return a value from your implementation of this function.

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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Winbio.h

See also

WinBioAsyncOpenSession
WinBioOpenSession

 

 

Community Additions

ADD
Show:
© 2014 Microsoft