Freigeben über

INetFwAuthorizedApplications::Item-Methode (netfw.h)

  • Artikel

[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