INetFwServiceRestriction::ServiceRestricted-Methode (netfw.h)

Artikel
02/29/2024

Die ServiceRestricted-Methode gibt an, ob Diensteinschränkungsregeln aktiviert sind, um den Datenverkehr auf die von den Firewallregeln angegebenen Ressourcen zu beschränken.

Syntax

HRESULT ServiceRestricted(
  [in]  BSTR         serviceName,
  [in]  BSTR         appName,
  [out] VARIANT_BOOL *serviceRestricted
);

Parameter

[in] serviceName

Name des abgefragten Diensts in Bezug auf den Status der Diensteinschränkung.

[in] appName

Name der Anwendung, die in Bezug auf den Status der Diensteinschränkung abgefragt wird.

[out] serviceRestricted

Gibt an, ob Diensteinschränkungsregeln zum Einschränken des angegebenen Diensts vorhanden sind. Wenn true (VARIANT_TRUE), ist der Dienst eingeschränkt. Andernfalls ist der Dienst nicht auf die durch Firewallregeln angegebenen Ressourcen beschränkt.

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	Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen.
E_OUTOFMEMORY	Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode aufgrund eines ungültigen Zeigers.

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	Die Methode ist aufgrund eines ungültigen Parameters fehlgeschlagen.
E_OUTOFMEMORY	Die Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_POINTER	Fehler bei der Methode aufgrund eines ungültigen Zeigers.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netfw.h
DLL	FirewallAPI.dll

Weitere Informationen

INetFwServiceRestriction

Freigeben über