FwpmEngineOpen0-Funktion (fwpmu.h)

Artikel
08/23/2023

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

Syntax

DWORD 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

Typ: const wchar_t*

Dieser Wert muss NULL sein.

[in] authnService

Typ: UINT32

Gibt den zu verwendenden Authentifizierungsdienst an. Zulässige Dienste sind RPC_C_AUTHN_WINNT und RPC_C_AUTHN_DEFAULT.

[in, optional] authIdentity

Typ: SEC_WINNT_AUTH_IDENTITY_A*

Die Anmeldeinformationen für die Authentifizierung und Autorisierung für den Zugriff auf die Filter-Engine. Dieser Zeiger ist optional und kann NULL sein. Wenn dieser Zeiger NULL ist, werden die Anmeldeinformationen des aufrufenden Threads verwendet.

[in, optional] session

Typ: FWPM_SESSION0*

Sitzungsspezifische Parameter für die geöffnete Sitzung. Dieser Zeiger ist optional und kann NULL sein.

[out] engineHandle

Typ: HANDLE*

Handle für die geöffnete Sitzung für die Filter-Engine.

Rückgabewert

Art: DWORD

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Die Sitzung wurde erfolgreich gestartet.
FWP_E_ALREADY_EXISTS 0x80320009	Eine Sitzung mit dem angegebenen sessionKey ist bereits geöffnet.
*FWP_E_-Fehlercode** 0x80320001 – 0x80320039	Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere Informationen finden Sie unter WFP-Fehlercodes .
*RPC_-Fehlercode** 0x80010001 – 0x80010122	Fehler bei der Kommunikation mit der Remote- oder lokalen Firewall-Engine.

Hinweise

Eine Benutzeranwendung muss FwpmEngineOpen0 aufrufen, um ein Handle für die geöffnete Sitzung für die Filter-Engine zu erhalten, bevor Filterobjekte hinzugefügt oder entfernt werden. Ein Handle für eine geöffnete Sitzung mit der Filter-Engine ist auch für die meisten anderen Verwaltungsfunktionen der Windows-Filterplattform erforderlich.

Die Sitzung wird automatisch geschlossen, wenn das Programm endet. Um eine Sitzung explizit zu schließen, rufen Sie FwpmEngineClose0 auf.

Wenn-Sitzung. Flags ist auf FWPM_SESSION_FLAG_DYNAMIC festgelegt. Alle WFP-Objekte, die während der Sitzung hinzugefügt werden, werden automatisch gelöscht, wenn die Sitzung endet. Wenn die Sitzung nicht dynamisch ist, muss der Aufrufer explizit alle WFP-Objekte löschen, die während der Sitzung hinzugefügt wurden.

Der Aufrufer benötigt FWPM_ACTRL_OPEN Zugriff auf die Filter-Engine. Weitere Informationen finden Sie unter Access Control.

FwpmEngineOpen0 ist nur für die Verwendung im Nicht-Identitätswechsel-Modus vorgesehen.

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

Beispiele

Im folgenden C++-Beispiel wird FwpmEngineOpen0 verwendet, um eine Filtersitzung zu öffnen.

// Open a session to the filter engine
        
HANDLE    engineHandle = NULL;
DWORD    result = ERROR_SUCCESS; 

printf("Opening the filter engine.\n");
        
result = FwpmEngineOpen0(
    NULL, 
    RPC_C_AUTHN_WINNT, 
    NULL,
    NULL, 
    &engineHandle );

if (result != ERROR_SUCCESS)
    printf("FwpmEngineOpen0 failed. Return value: %d.\n", result); 
else
    printf("Filter engine opened successfully.\n");

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fwpmu.h
Bibliothek	Fwpuclnt.lib
DLL	Fwpuclnt.dll