Metodo INetFwPolicy2::IsRuleGroupEnabled (netfw.h)

Articolo
03/05/2024

Il metodo IsRuleGroupEnabled determina se un gruppo specificato di regole del firewall è abilitato o disabilitato.

Sintassi

HRESULT IsRuleGroupEnabled(
  [in]  long         profileTypesBitmask,
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

Parametri

[in] profileTypesBitmask

Maschera di profili da NET_FW_PROFILE_TYPE2.

[in] group

Stringa usata per raggruppare le regole. Può essere il nome del gruppo o una stringa indiretta al nome del gruppo sotto forma di "@yourresourcedll.dll,-23255". Le regole appartenenti a questo gruppo verranno sottoposte a query.

[out] enabled

Indica se il gruppo di regole identificate dal parametro di gruppo è abilitato o disabilitato.

Se questo valore è impostato su true (VARIANT_TRUE), il gruppo di regole è abilitato; in caso contrario, il gruppo è disabilitato.

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
ACCESSDENIED	L'operazione è stata interrotta a causa di problemi di autorizzazioni.
E_INVALIDARG	Il metodo non è riuscito a causa di un parametro non valido.
E_POINTER	Il metodo non è riuscito perché un puntatore non è valido.
S_FALSE	Il gruppo richiesto non esiste.

VB

Questa chiamata restituisce uno stato di abilitazione booleano che indica se il gruppo di regole identificate dal parametro di gruppo è abilitato o disabilitato. Se questo valore è impostato su true (VARIANT_TRUE), il gruppo di regole è abilitato; in caso contrario, il gruppo è disabilitato.

Commenti

Quando le stringhe indirette sotto forma di "@yourresourcedll.dll,-23255" vengono passate come parametri a Windows Firewall con API di sicurezza avanzate, devono essere posizionate nella directory di Windows System32 o specificata da un percorso completo. Inoltre, il file deve avere un accesso sicuro che consente all'account del servizio locale l'accesso in lettura per consentire al servizio Windows Firewall di leggere le stringhe. Per evitare che le entità di sicurezza non con privilegi modifichino le stringhe, le DLL devono consentire solo l'accesso in scrittura all'account amministratore.

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

INetFwPolicy2

Condividi tramite