INetFwRules::Remove-Methode (netfw.h)

Die Remove-Methode entfernt eine Regel aus der Auflistung.

Syntax

HRESULT Remove(
  [in] BSTR name
);

Parameter

[in] name

Name der Regel, die aus der Auflistung entfernt 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
E_ACCESSDENIED
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen.
E_INVALIDARG
Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen.
E_OUTOFMEMORY
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
 

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
E_ACCESSDENIED
Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen.
E_INVALIDARG
Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen.
E_OUTOFMEMORY
Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

Wenn eine durch den name-Parameter angegebene Regel nicht in der Auflistung vorhanden ist, hat die Remove-Methode keine Auswirkung.

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

INetFwRules