INetFwRule::p ut_Grouping-Methode (netfw.h)
Gibt die Gruppe an, zu der eine einzelne Regel gehört.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT put_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 |