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
);

Parameter

[in] name

Name der abzurufenden Regel.

[out] rule

Verweis auf das zurückgegebene INetFwRule-Objekt .

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
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.
 

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
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.

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

INetFwRules