PWINBIO_LOCATE_SENSOR_CALLBACK Rückruffunktion (winbio.h)

  • Artikel

Wird vom Windows Biometric Framework aufgerufen, um Ergebnisse aus der asynchronen WinBioLocateSensorWithCallback-Funktion zurückzugeben. Die Clientanwendung muss diese Funktion implementieren.

Wichtig Es wird empfohlen, ab Windows 8 die PWINBIO_LOCATE_SENSOR_CALLBACK/WinBioLocateSensorWithCallback-Kombination nicht mehr zu verwenden. Gehen Sie stattdessen wie folgt vor:
  • Implementieren Sie eine PWINBIO_ASYNC_COMPLETION_CALLBACK-Funktion , um Benachrichtigungen zu erhalten, wenn der Vorgang abgeschlossen ist.
  • Rufen Sie die WinBioAsyncOpenSession-Funktion auf. Übergeben Sie die Adresse Ihres Rückrufs im Parameter CallbackRoutine . Übergeben Sie WINBIO_ASYNC_NOTIFY_CALLBACK im NotificationMethod-Parameter . Rufen Sie ein asynchrones Sitzungshandle ab.
  • Verwenden Sie das asynchrone Sitzungshandle, um WinBioLocateSensor aufzurufen. Nach Abschluss des Vorgangs ordnet und initialisiert das Biometrische Windows-Framework eine WINBIO_ASYNC_RESULT-Struktur mit den Ergebnissen und ruft Ihren Rückruf mit einem Zeiger auf die Ergebnisstruktur auf.
  • Rufen Sie WinBioFree aus Ihrer Rückrufimplementierung auf, um die WINBIO_ASYNC_RESULT-Struktur freizugeben, nachdem Sie sie verwendet haben.
 

Syntax

PWINBIO_LOCATE_SENSOR_CALLBACK PwinbioLocateSensorCallback;

void PwinbioLocateSensorCallback(
  [in, optional] PVOID LocateCallbackContext,
  [in]           HRESULT OperationStatus,
                 WINBIO_UNIT_ID UnitId
)
{...}

Parameter

[in, optional] LocateCallbackContext

Zeiger auf einen Puffer, der von der Anwendung definiert und an den LocateCallbackContext-Parameter der WinBioLocateSensorWithCallback-Funktion übergeben wird. Der Puffer wird vom Framework oder der biometrischen Einheit nicht geändert. Ihre Anwendung kann die Daten verwenden, um zu ermitteln, welche Aktionen ausgeführt werden sollen, oder um zusätzliche Informationen zur biometrischen Erfassung zu erhalten.

[in] OperationStatus

Fehlercode, der vom Erfassungsvorgang zurückgegeben wird.

UnitId

Biometrische Einheits-ID-Nummer.

Rückgabewert

Keine

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbio.h