Metodo INetFwServiceRestriction::RestrictService (netfw.h)

Articolo
08/25/2023

Il metodo RestrictService attiva o disattiva la restrizione del servizio per un determinato servizio.

Sintassi

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

Parametri

[in] serviceName

Nome del servizio per cui viene attivata o disattivata la restrizione del servizio.

[in] appName

Nome dell'applicazione per cui viene attivata o disattivata la restrizione del servizio.

[in] restrictService

Indica se la restrizione del servizio viene attivata o disattivata. Se questo valore è true (VARIANT_TRUE), il servizio verrà limitato durante l'invio o la ricezione del traffico di rete. La raccolta di regole di protezione avanzata del servizio Windows può contenere regole che possono consentire questo servizio specifico accesso in ingresso o in uscita per requisiti specifici. Se false (VARIANT_FALSE), il servizio non è limitato dalla protezione avanzata del servizio Windows.

[in] serviceSidRestricted

Indica il tipo di SID del servizio per il servizio specificato. Se questo valore è true (VARIANT_TRUE), il SID del servizio sarà limitato. In caso contrario, sarà senza restrizioni.

Valore restituito

C++

Se il metodo ha esito positivo, il valore restituito è S_OK.

Se il metodo ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
E_ACCESSDENIED	L'operazione è stata interrotta a causa di problemi di autorizzazioni.
E_INVALIDARG	Il metodo non è riuscito a causa di un parametro non valido.

VB

Se il metodo ha esito positivo, il valore restituito è S_OK.

Se il metodo ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
E_ACCESSDENIED	L'operazione è stata interrotta a causa di problemi di autorizzazioni.
E_INVALIDARG	Il metodo non è riuscito a causa di un parametro non valido.

Commenti

Quando si aggiungono regole, si noti che potrebbe esserci un intervallo di tempo ridotto prima che venga applicata la regola appena aggiunta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	netfw.h
DLL	FirewallAPI.dll

Vedi anche

INetFwServiceRestriction

Condividi tramite