INetFwRules::Item-Methode (netfw.h)

Die Item-Methode gibt die angegebene Regel zurück, wenn sie sich in der Auflistung befindet.

Syntax

HRESULT Item(
  [in]  BSTR       name,
  [out] INetFwRule **rule
);

[in] name

Name der abzurufenden Regel.

[out] rule

Verweis auf das zurückgegebene INetFwRule-Objekt .

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	Fehler bei der Methode aufgrund eines ungültigen Parameters.
E_OUTOFMEMORY	Die -Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode aufgrund eines ungültigen Zeigers.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Das angeforderte Element ist nicht vorhanden.

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	Fehler bei der Methode aufgrund eines ungültigen Parameters.
E_OUTOFMEMORY	Die -Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode aufgrund eines ungültigen Zeigers.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Das angeforderte Element ist nicht vorhanden.

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