FwpmEngineOpen0-Funktion (fwpmk.h)
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 |