FwpmSessionCreateEnumHandle0-Funktion (fwpmu.h)

Die FwpmSessionCreateEnumHandle0-Funktion erstellt ein Handle, das zum Auflisten einer Reihe von Sitzungsobjekten verwendet wird.

Syntax

DWORD FwpmSessionCreateEnumHandle0(
  [in]           HANDLE                            engineHandle,
  [in, optional] const FWPM_SESSION_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                            *enumHandle
);

Parameter

[in] engineHandle

Typ: HANDLE

Handle für eine geöffnete Sitzung für die Filter-Engine. Rufen Sie FwpmEngineOpen0 auf, um eine Sitzung für die Filter-Engine zu öffnen.

[in, optional] enumTemplate

Typ: FWPM_SESSION_ENUM_TEMPLATE0*

Vorlage, um die Enumeration selektiv einzuschränken.

[out] enumHandle

Typ: HANDLE*

Handle für Filteraufzählung.

Rückgabewert

Art: DWORD

Hinweise

Wenn enumTemplateNULL ist, werden alle Sitzungsobjekte zurückgegeben.

Der Aufrufer muss das zurückgegebene Handle durch einen Aufruf an fwpmSessionDestroyEnumHandle0 freigeben.

FwpmSessionCreateEnumHandle0 kann nicht innerhalb einer Transaktion aufgerufen werden. Bei FWP_E_TXN_IN_PROGRESS tritt ein Fehler auf. Weitere Informationen zu Transaktionen finden Sie unter Objektverwaltung .

Der Aufrufer benötigt FWPM_ACTRL_ENUM Zugriff auf das Filtermodul. Weitere Informationen finden Sie unter Access Control.

FwpmSessionCreateEnumHandle0 ist eine spezifische Implementierung von FwpmSessionCreateEnumHandle. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Anforderungen

Weitere Informationen

FWPM_SESSION_ENUM_TEMPLATE0

FwpmSessionDestroyEnumHandle0