FwpmCalloutCreateEnumHandle0-Funktion (fwpmk.h)
Die FwpmCalloutCreateEnumHandle0-Funktion erstellt ein Handle zum Aufzählen einer Reihe von Legendenobjekten.
Syntax
NTSTATUS FwpmCalloutCreateEnumHandle0(
[in] HANDLE engineHandle,
[in, optional] const FWPM_CALLOUT_ENUM_TEMPLATE0 *enumTemplate,
[out] HANDLE *enumHandle
);
Parameter
[in] engineHandle
Behandeln einer geöffneten Sitzung für das Filtermodul. Rufen Sie FwpmEngineOpen0- auf, um eine Sitzung für das Filtermodul zu öffnen.
[in, optional] enumTemplate
Vorlage, um die Enumeration selektiv einzuschränken.
[out] enumHandle
Handle der neu erstellten Enumeration.
Rückgabewert
| Zurückgeben von Code/Wert | Beschreibung |
|---|---|
|
ERROR_SUCCESS 0 |
Der Enumerator wurde erfolgreich erstellt. |
|
FWP_E_* Fehlercode 0x80320001 – 0x80320039 |
Ein WFP-spezifischer Fehler (Windows-Filterplattform). Weitere Informationen finden Sie unter WFP-Fehlercodes. |
|
RPC_*-Fehlercode 0x80010001 – 0x80010122 |
Fehler bei der Kommunikation mit dem Remote- oder lokalen Firewallmodul. |
| Andere NTSTATUS-Codes | Fehler. |
Bemerkungen
Wenn enumerationTemplate-NULL-ist, werden alle Legendenobjekte zurückgegeben.
Der Enumerator ist nicht live, d. h. es spiegelt keine Änderungen am System wider, die nach dem Aufruf von FwpmCalloutCreateEnumHandle0 zurückgegeben werden. Wenn Sie sicherstellen müssen, dass die Ergebnisse aktuell sind, müssen Sie FwpmCalloutCreateEnumHandle0 und FwpmCalloutEnum0 innerhalb derselben expliziten Transaktion aufrufen.
Der Aufrufer muss FwpmCalloutDestroyEnumHandle0 aufrufen, um das zurückgegebene Handle freizugeben.
Der Aufrufer benötigt FWPM_ACTRL_ENUM Zugriff auf die Popupcontainer und FWPM_ACTRL_READ Zugriff auf die Legenden. Nur Legenden, auf die der Anrufer FWPM_ACTRL_READ Zugriff hat, wird zurückgegeben. Weitere Informationen finden Sie unter Zugriffssteuerungs-.
FwpmCalloutCreateEnumHandle0 ist eine spezifische Implementierung von FwpmCalloutCreateEnumHandle. 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 |
| Library | fwpkclnt.lib |
| IRQL- | <= PASSIVE_LEVEL |