INetFwRule::get_Grouping-Methode (netfw.h)

  • Artikel

Gibt die Gruppe an, zu der eine einzelne Regel gehört.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_Grouping(
  BSTR *context
);

Parameter

context

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft ist optional.

Lesen Sie auch die Einschränkungen für das Ändern von Eigenschaften, die im Abschnitt Hinweise der INetFwRule-Schnittstellenseite beschrieben sind.

Die Verwendung der Gruppierungseigenschaft wird dringend empfohlen, da sie mehrere Regeln in einer einzigen Zeile in der Windows-Firewall-Systemsteuerung gruppiert. Dadurch kann der Benutzer mehrere Regeln mit einem einzigen Klick aktivieren oder deaktivieren. Die Grouping-Eigenschaft kann auch mithilfe indirekter Zeichenfolgen angegeben werden. In diesem Fall kann auch eine Gruppenbeschreibung angegeben werden, die in den Eigenschaften der Regelgruppe in der Windows-Firewall-Systemsteuerung angezeigt wird. Wenn die Gruppenzeichenfolge beispielsweise durch eine indirekte Zeichenfolge am Index 1005 ("@yourresources.dll,-1005") angegeben wird, kann die Gruppenbeschreibung in einer Ressourcenzeichenfolge angegeben werden, die um 10000 "@youresources.dll,-11005" höher ist.

Wenn indirekte Zeichenfolgen in Form von "h" als Parameter an die Windows-Firewall mit erweiterten Sicherheits-APIs übergeben werden, sollten sie entweder unter dem Windows-Verzeichnis System32 platziert oder durch einen vollständigen Pfad angegeben werden. Darüber hinaus sollte die Datei über einen sicheren Zugriff verfügen, der dem lokalen Dienstkonto Lesezugriff ermöglicht, damit der Windows-Firewalldienst die Zeichenfolgen lesen kann. Um zu vermeiden, dass nicht privilegierte Sicherheitsprinzipale die Zeichenfolgen ändern, sollten die DLLs nur Schreibzugriff auf das Administratorkonto zulassen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile netfw.h
DLL FirewallAPI.dll

Weitere Informationen

INetFwRule