INetFwAuthorizedApplications::Item-Methode (netfw.h)

Artikel
02/29/2024

[Die Windows-Firewall-API steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. 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.]

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

Syntax

HRESULT Item(
  [in]  BSTR                        imageFileName,
  [out] INetFwAuthorizedApplication **app
);

Parameter

[in] imageFileName

Abzurufende Anwendung.

[out] app

Verweis auf das zurückgegebene INetFwAuthorizedApplication-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, 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

INetFwAuthorizedApplication

INetFwAuthorizedApplications

Freigeben über