INetFwRules::Add-Methode (netfw.h)
Die Add-Methode fügt der Auflistung eine neue Regel hinzu.
Syntax
HRESULT Add(
[in] INetFwRule *rule
);
Parameter
[in] rule
Regel, die der Auflistung über ein INetFwRule-Objekt hinzugefügt werden soll.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.Wenn die Methode fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen. |
|
Bei der Methode ist ein Fehler aufgetreten, weil ein Parameter ungültig war. |
|
Bei der Methode ist ein Fehler aufgetreten, da sich das Objekt bereits in der Auflistung befindet. |
VB
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.Wenn die Methode fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen. |
|
Bei der Methode ist ein Fehler aufgetreten, weil ein Parameter ungültig war. |
|
Bei der Methode ist ein Fehler aufgetreten, da sich das Objekt bereits in der Auflistung befindet. |
Hinweise
Wenn bereits eine Regel mit demselben Regelbezeichner wie die übermittelte vorhanden ist, wird die vorhandene Regel überschrieben.
Das Hinzufügen einer Firewallregel mit einer angegebenen LocalAppPackageId kann zu unerwartetem Verhalten führen und wird nicht unterstützt.
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 |