INetFwMgr::IsIcmpTypeAllowed-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.]

Bestimmt, ob der angegebene ICMP-Typ zulässig ist.

Syntax

HRESULT IsIcmpTypeAllowed(
  [in]  NET_FW_IP_VERSION ipVersion,
  [in]  BSTR              localAddress,
  [in]  BYTE              type,
  [out] VARIANT           *allowed,
  [out] VARIANT           *restricted
);

Parameter

[in] ipVersion

IP-Version des Datenverkehrs. Dies kann nicht NET_FW_IP_VERSION_ANY werden.

[in] localAddress

Entweder eine gepunktete dezimale IPv4-Adresse oder eine IPv6-Sechskantadresse, die die lokale Adresse des Datenverkehrs angibt. In der Regel ist dies die Adresse, die an die Bindung übergeben wird. Wenn localAddressNULL ist, bestimmt die Funktion, ob der Port für alle Schnittstellen zulässig ist.

[in] type

ICMP-Typ. Eine Liste der möglichen ICMP-Typen finden Sie unter ICMP-Typnummern.

[out] allowed

Gibt durch den Wert VARIANT_TRUE oder VARIANT_FALSE an, ob der Port für mindestens einige lokale Schnittstellen und Remoteadressen zulässig ist.

[out] restricted

Gibt durch den Wert VARIANT_TRUE oder VARIANT_FALSE an, ob einige lokale Schnittstellen oder Remoteadressen für diesen Port blockiert sind. Beispielsweise, wenn der Port nur auf das lokale Subnetz beschränkt ist.

Rückgabewert

C++

Rückgabecode	Beschreibung
E_ACCESSDENIED	Der Vorgang wurde aufgrund von Berechtigungsproblemen beendet.
E_INVALIDARG	Fehler bei der Methode, weil ein Parameter ungültig war.
E_OUTOFMEMORY	Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode, weil ein Zeiger ungültig war.

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 beendet.
E_INVALIDARG	Fehler bei der Methode, weil ein Parameter ungültig war.
E_OUTOFMEMORY	Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode, weil ein Zeiger ungültig war.

Hinweise

Anstelle dieser Methode wird allgemein die INetFwPolicy2::IsRuleGroupEnabled-Methode empfohlen.

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

INetFwMgr

NET_FW_IP_VERSION

Freigeben über