INetFwOpenPorts::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.]

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

Syntax

HRESULT Item(
  [in]  LONG               portNumber,
  [in]  NET_FW_IP_PROTOCOL ipProtocol,
  [out] INetFwOpenPort     **openPort
);

Parameter

[in] portNumber

Portnummer, die gesucht werden soll.

[in] ipProtocol

Protokoll des zu suchenden Ports nach Typ NET_FW_IP_PROTOCOL.

[out] openPort

Verweis auf das zurückgegebene INetFwOpenPort-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.

Fehler	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

Verweis auf das zurückgegebene INetFwOpenPort-Objekt .

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

INetFwOpenPort

INetFwOpenPorts

NET_FW_IP_PROTOCOL

Freigeben über