FWPM_CALLOUT0-Struktur (fwpmtypes.h)

  • Artikel

Die FWPM_CALLOUT0-Struktur speichert den Zustand, der einer Legende zugeordnet ist.

Syntax

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

Member

calloutKey

Identifiziert die Sitzung eindeutig.

Wenn die GUID im Aufruf von FwpmCalloutAdd0 auf Null initialisiert wird, generiert die Basisfilter-Engine (BFE) eine.

displayData

Eine FWPM_DISPLAY_DATA0 Struktur, die für Menschen lesbare Anmerkungen enthält, die der Legende zugeordnet sind. Das Namenselement der FWPM_DISPLAY_DATA0-Struktur ist erforderlich.

flags

Wert Bedeutung
FWPM_CALLOUT_FLAG_PERSISTENT
 Die Legende ist bei Neustarts dauerhaft. Daher kann durch Startzeit und andere persistente Filter darauf verwiesen werden.
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT
 Die Legende benötigt Zugriff auf den Anbieterkontext, der im Filter gespeichert ist, der die Legende aufruft. Wenn dieses Flag festgelegt ist, wird der Anbieterkontext aus der [FWPM_FILTER0](/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0)-Struktur in die FWPS_FILTER0-Struktur kopiert. Die FWPS_FILTER0 Struktur ist im WDK dokumentiert.
FWPM_CALLOUT_FLAG_REGISTERED
 Die Legende ist derzeit im Kernel registriert. Dieses Flag darf nicht festgelegt werden, wenn neue Legenden hinzugefügt werden. Sie wird nur zum Abfragen des Zustands vorhandener Legenden verwendet.

providerKey

Identifiziert eindeutig den Anbieter, der der Legende zugeordnet ist. Wenn der Member nicht NULL ist, werden nur Objekte zurückgegeben, die dem angegebenen Anbieter zugeordnet sind.

providerData

Eine FWP_BYTE_BLOB-Struktur , die optionale anbieterspezifische Daten enthält, mit denen Anbieter zusätzliche Kontextinformationen mit dem -Objekt speichern können.

applicableLayer

Gibt die Ebene an, auf der die Beschriftung verwendet werden kann. Nur Filter in dieser Ebene können die Legende aufrufen. Weitere Informationen finden Sie unter Filtern von Ebenenbezeichnern.

calloutId

LUID, die die Beschriftung identifiziert. Dies ist die calloutId , die in der FWPS_ACTION0-Struktur für Filter gespeichert ist, die eine Legende aufrufen. Die FWPS_ACTION0 Struktur ist im WDK dokumentiert.

Hinweise

Die ersten sechs Member dieser Struktur enthalten Daten, die beim Hinzufügen von Objekten bereitgestellt werden.

Der letzte Member , calloutId, stellt zusätzliche Informationen bereit, die beim Abrufen/Aufzählen von Objekten zurückgegeben werden.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile fwpmtypes.h

Weitere Informationen

API-Strukturen der Windows-Filterplattform