FwpmEngineOpen0-Funktion (fwpmu.h)
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 |
---|---|
|
Die Sitzung wurde erfolgreich gestartet. |
|
Eine Sitzung mit dem angegebenen sessionKey ist bereits geöffnet. |
|
Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere Informationen finden Sie unter WFP-Fehlercodes . |
|
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 |