FwpmEngineOpen0-Funktion (fwpmk.h)

Artikel
03/05/2024

Die Funktion FwpmEngineOpen0 öffnet eine Sitzung für die Filter-Engine.

Hinweis

FwpmEngineOpen0 ist eine bestimmte Version von FwpmEngineOpen. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

Syntax

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

Parameter

[in, optional] serverName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den DNS-Standardnamen des Systems angibt, auf dem die Sitzung mit der Filter-Engine geöffnet wird. Legendentreiber müssen NULL für diesen Parameter angeben.

[in] authnService

Der zu verwendende Authentifizierungsdienst. Eine Liste der gültigen Optionen für diesen Parameter finden Sie unter Authentication-Service Konstanten im Abschnitt RPC der Microsoft Windows SDK-Dokumentation. Legendentreiber müssen entweder RPC_C_AUTHN_WINNT oder RPC_C_AUTHN_DEFAULT für diesen Parameter angeben.

[in, optional] authIdentity

Ein Zeiger auf eine SEC_WINNT_AUTH_IDENTITY_W Struktur, die die Anmeldeinformationen für die Authentifizierung und Autorisierung für den Zugriff auf die Filter-Engine enthält. Dieser Parameter wird ignoriert, wenn die Funktion FwpmEngineOpen0 von einem Legendentreiber aufgerufen wird. Legendentreiber sollten diesen Parameter auf NULL festlegen.

[in, optional] session

Ein Zeiger auf eine FWPM_SESSION0-Struktur , die sitzungsspezifische Parameter für die geöffnete Sitzung definiert. Dieser Zeiger ist optional und kann NULL sein.

[out] engineHandle

Ein Zeiger auf eine Variable, die ein Handle für die geöffnete Sitzung an die Filter-Engine empfängt.

Rückgabewert

Die FwpmEngineOpen0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Eine Sitzung mit der Filter-Engine wurde erfolgreich geöffnet. Die Variable, auf die der engineHandle-Parameter verweist, enthält ein Handle für die geöffnete Sitzung.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber ruft die FwpmEngineOpen0-Funktion auf, um eine Sitzung für die Filter-Engine zu öffnen. Ein Handle für eine geöffnete Sitzung für die Filter-Engine ist ein erforderlicher Parameter für die meisten Verwaltungsfunktionen der Windows-Filterplattform.

Legendentreiber müssen normalerweise keine Sitzung für die Filter-Engine öffnen, da Legendentreiber in der Regel keine der Verwaltungsfunktionen der Windows-Filterplattform aufrufen.

Damit ein Legendentreiber erfolgreich eine Sitzung für die Filter-Engine öffnen kann, muss die Filter-Engine zu dem Zeitpunkt ausgeführt werden, zu dem der Legendentreiber die Funktion FwpmEngineOpen0 aufruft . Ein Legendentreiber kann die FwpmBfeStateGet0-Funktion aufrufen, um den aktuellen Zustand der Filter-Engine abzurufen. Vor dem Aufruf von FwpmBfeStateGet0 muss der Legendentreiber die FwpmBfeStateSubscribeChanges0-Funktion aufrufen, um eine Rückruffunktion zu registrieren, die aufgerufen wird, wenn der Status der Filter-Engine geändert wird.

Nachdem ein Legendentreiber den Zugriff auf die Filter-Engine abgeschlossen hat, ruft er die Funktion FwpmEngineClose0 auf, um die geöffnete Sitzung für die Filter-Engine zu schließen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Zielplattform	Universell
Header	fwpmk.h (schließen Sie Fwpmk.h ein)
Bibliothek	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL