INetFwServices::Item-Methode (netfw.h)

Artikel
02/29/2024

[Die Windows-Firewall-API ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Für Windows Vista und höher wird die Verwendung der Windows-Firewall mit erweiterter Sicherheits-API empfohlen.]

Gibt den angegebenen Dienst zurück, wenn er sich in der Auflistung befindet.

Syntax

HRESULT Item(
  [in]  NET_FW_SERVICE_TYPE svcType,
  [out] INetFwService       **service
);

Parameter

[in] svcType

C++	Typ des abzurufenden Diensts.
VB	Typ des abzurufenden Diensts. Siehe NET_FW_SERVICE_TYPE

[out] service

C++	Verweis auf das zurückgegebene INetFwService-Objekt .
VB	Verweis auf das zurückgegebene INetFwService-Objekt .

Rückgabewert

C++

Rückgabecode	Beschreibung
E_ACCESSDENIED	Der Vorgang wurde aufgrund von Berechtigungsproblemen abgebrochen.
E_OUTOFMEMORY	Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode aufgrund eines ungültigen Zeigers.
E_INVALIDARG	Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Bei der Methode ist ein Fehler aufgetreten, da das angeforderte Element nicht vorhanden ist.

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_OUTOFMEMORY	Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode aufgrund eines ungültigen Zeigers.
E_INVALIDARG	Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Bei der Methode ist ein Fehler aufgetreten, da das angeforderte Element nicht vorhanden ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netfw.h
DLL	FirewallAPI.dll; Hnetcfg.dll unter Windows XP mit SP2

Weitere Informationen

INetFwService

INetFwServices

NET_FW_SERVICE_TYPE

Freigeben über