WbioQueryEngineInterface-Funktion (winbio_adapter.h)

  • Artikel

Ruft einen Zeiger auf die WINBIO_ENGINE_INTERFACE-Struktur für den Engine-Adapter ab.

Syntax

HRESULT WbioQueryEngineInterface(
  [out] PWINBIO_ENGINE_INTERFACE *EngineInterface
);

Parameter

[out] EngineInterface

Adresse einer Variablen, die einen Zeiger auf die WINBIO_ENGINE_INTERFACE-Struktur empfängt.

Rückgabewert

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

Rückgabecode Beschreibung
E_POINTER
 Der EngineInterface-Parameter darf nicht NULL sein.

Hinweise

Das Windows Biometric Framework ruft diese Funktion auf, nachdem eine Moduladapter-DLL in den Arbeitsspeicher geladen wurde. Jede Moduladapter-DLL muss daher die WbioQueryEngineInterface-Funktion implementieren und exportieren. Beim Funktionsnamen wird die Groß-/Kleinschreibung beachtet, und die Schreibweise und Signatur müssen genau mit der im Abschnitt Syntax angegebenen übereinstimmen.

Um für das Windows Biometric Framework sichtbar zu sein, muss die WbioQueryEngineInterface-Funktion im Abschnitt EXPORTS der Exportdefinitionslinkerbefehlsdatei für die DLL benannt werden.

Beispiele

Der folgende Pseudocode zeigt eine mögliche Implementierung dieser Funktion.

HRESULT
WINAPI
WbioQueryEngineInterface(
    __out PWINBIO_ENGINE_INTERFACE *EngineInterface)
{
    // g_EngineInterface is a global variable.
    *EngineInterface = &g_EngineInterface;
    return S_OK;
}

Anforderungen

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

Weitere Informationen

Plug-In-Funktionen