FwpmEngineOpen0-Funktion (fwpmk.h)

  • Artikel

Die FwpmEngineOpen0--Funktion öffnet eine Sitzung für das Filtermodul.

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 MIT NULL beendete Zeichenfolge, die den standardmäßigen DNS-Namen des Systems angibt, auf dem die Sitzung mit dem Filtermodul geöffnet wird. Legendentreiber müssen NULL- für diesen Parameter angeben.

[in] authnService

Der zu verwendende Authentifizierungsdienst. Eine Liste der gültigen Auswahlmöglichkeiten für diesen Parameter finden Sie unter Authentication-Service Konstanten im Abschnitt "RPC" in der Dokumentation zum Microsoft Windows SDK. 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 Authentifizierungs- und Autorisierungsanmeldeinformationen für den Zugriff auf das Filtermodul enthält. Dieser Parameter wird ignoriert, wenn die FwpmEngineOpen0-Funktion von einem Popuptreiber 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 auf das Filtermodul empfängt.

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_SUCCESS Eine Sitzung mit dem Filtermodul wurde erfolgreich geöffnet. Die Variable, auf die vom engineHandle-Parameter verwiesen wird, enthält ein Handle für die geöffnete Sitzung.
Andere NTSTATUS-Codes Fehler.

Bemerkungen

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

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

Damit ein Popuptreiber eine Sitzung erfolgreich mit dem Filtermodul öffnen kann, muss das Filtermodul zurzeit ausgeführt werden, wenn der Popuptreiber den FwpmEngineOpen0-Funktion aufruft. Ein Popuptreiber kann die FwpmBfeStateGet0--Funktion aufrufen, um den aktuellen Status des Filtermoduls abzurufen. Vor dem Aufrufen FwpmBfeStateGet0muss der Popuptreiber die FwpmBfeStateSubscribeChanges0-Funktion aufrufen, um eine Rückruffunktion zu registrieren, die aufgerufen wird, wenn sich der Status des Filtermoduls ändert.

Nachdem ein Popuptreiber den Zugriff auf das Filtermodul beendet hat, ruft er die FwpmEngineClose0- funktion auf, um die geöffnete Sitzung mit dem Filtermodul zu schließen.

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar ab Windows Vista.
Zielplattform- Universal
Header- fwpmk.h (include Fwpmk.h)
Library Fwpkclnt.lib
IRQL- PASSIVE_LEVEL

Siehe auch