PIBIO_STORAGE_OPEN_DATABASE_FN Rückruffunktion (winbio_adapter.h)

Artikel
03/03/2024

Wird vom Windows Biometric Framework aufgerufen, um eine Datenbank zu öffnen.

Syntax

PIBIO_STORAGE_OPEN_DATABASE_FN PibioStorageOpenDatabaseFn;

HRESULT PibioStorageOpenDatabaseFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_UUID DatabaseId,
  [in]      LPCWSTR FilePath,
  [in]      LPCWSTR ConnectString
)
{...}

Parameter

[in, out] Pipeline

Zeiger auf die WINBIO_PIPELINE Struktur, die der biometrischen Einheit zugeordnet ist, die den Vorgang ausführt.

[in] DatabaseId

Zeiger auf eine GUID, die die Datenbank eindeutig identifiziert. Dies ist dieselbe GUID, die zum Registrieren der Datenbank in der Registrierung verwendet wird.

[in] FilePath

Zeiger auf eine MIT NULL beendete Unicode-Zeichenfolge, die den vollqualifizierten Dateipfad für die Datenbank enthält.

[in] ConnectString

Zeiger auf eine MIT NULL beendete Unicode-Verbindungszeichenfolge für die Datenbank.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Wenn die Funktion fehlschlägt, muss sie einen der folgenden HRESULT-Werte zurückgeben, um den Fehler anzugeben.

Rückgabecode	Beschreibung
E_POINTER	Ein obligatorisches Zeigerargument ist NULL.
WINBIO_E_DATABASE_CANT_CREATE	Die Datenbank kann nicht erstellt werden.
WINBIO_E_DATABASE_CANT_FIND	Die angegebene Datenbank kann nicht gefunden werden.
WINBIO_E_DATABASE_LOCKED	Die Datenbank ist derzeit von einer anderen Anwendung gesperrt und kann nicht geöffnet werden.
WINBIO_E_DATABASE_CANT_OPEN	Ein nicht angegebenes Problem hat dazu geführt, dass die Anforderung fehlschlägt.
WINBIO_E_INVALID_DEVICE_STATE	Das StorageContext-Element des Pipelineobjekts ist NULL.

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_adapter.h (einschließlich Winbio_adapter.h)

Weitere Informationen

Plug-In-Funktionen

StorageAdapterCloseDatabase

StorageAdapterCreateDatabase

StorageAdapterEraseDatabase

Freigeben über