INetFwServiceRestriction::RestrictService-Methode (netfw.h)

Artikel
03/06/2024

Die RestrictService-Methode aktiviert oder deaktiviert die Diensteinschränkung für einen bestimmten Dienst.

Syntax

HRESULT RestrictService(
  [in] BSTR         serviceName,
  [in] BSTR         appName,
  [in] VARIANT_BOOL restrictService,
  [in] VARIANT_BOOL serviceSidRestricted
);

Parameter

[in] serviceName

Name des Diensts, für den die Diensteinschränkung aktiviert oder deaktiviert wird.

[in] appName

Name der Anwendung, für die die Diensteinschränkung aktiviert oder deaktiviert wird.

[in] restrictService

Gibt an, ob die Diensteinschränkung aktiviert oder deaktiviert wird. Wenn dieser Wert true (VARIANT_TRUE) ist, wird der Dienst beim Senden oder Empfangen von Netzwerkdatenverkehr eingeschränkt. Die Sammlung von Windows-Diensthärtungsregeln kann Regeln enthalten, die diesem dienstspezifischen eingehenden oder ausgehenden Netzwerkzugriff gemäß bestimmten Anforderungen ermöglichen können. Wenn false (VARIANT_FALSE), wird der Dienst nicht durch die Windows-Diensthärtung eingeschränkt.

[in] serviceSidRestricted

Gibt den Typ der Dienst-SID für den angegebenen Dienst an. Wenn dieser Wert true (VARIANT_TRUE) ist, wird die Dienst-SID eingeschränkt. Andernfalls ist sie uneingeschrä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	Fehler bei der Methode aufgrund eines ungültigen Parameters.

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.

Hinweise

Beachten Sie beim Hinzufügen von Regeln, dass es möglicherweise eine kleine Zeitverzögerung gibt, bevor die neu hinzugefügte Regel angewendet wird.

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