Interfaccia INetFwRule (netfw.h)
L'interfaccia INetFwRule consente di accedere alle proprietà di una regola.
Ereditarietà
L'interfaccia INetFwRule eredita dall'interfaccia IDispatch . INetFwRule include anche questi tipi di membri:
Metodi
L'interfaccia INetFwRule include questi metodi.
| INetFwRule::get_Action Specifica l'azione per una regola o un'impostazione predefinita. (INetFwRule.get_Action) |
| INetFwRule::get_ApplicationName Specifica il nome descrittivo dell'applicazione a cui si applica questa regola. (Get) |
| INetFwRule::get_Description Specifica la descrizione di questa regola. (Get) |
| INetFwRule::get_Direction Specifica la direzione del traffico per cui viene applicata la regola. (Get) |
| INetFwRule::get_EdgeTraversal Indica se l'attraversamento dei bordi è abilitato o disabilitato per questa regola. (Get) |
| INetFwRule::get_Enabled Abilita o disabilita una regola. (Get) |
| INetFwRule::get_Grouping Specifica il gruppo a cui appartiene una singola regola. (Get) |
| INetFwRule::get_IcmpTypesAndCodes Specifica l'elenco di tipi e codici ICMP per questa regola. (Get) |
| INetFwRule::get_Interfaces Specifica l'elenco di interfacce per cui viene applicata la regola. (Get) |
| INetFwRule::get_InterfaceTypes Specifica l'elenco di tipi di interfaccia per cui viene applicata la regola. (Get) |
| INetFwRule::get_LocalAddresses Specifica l'elenco di indirizzi locali per questa regola. (Get) |
| INetFwRule::get_LocalPorts Specifica l'elenco delle porte locali per questa regola. (Get) |
| INetFwRule::get_Name Specifica il nome descrittivo di questa regola. (Get) |
| INetFwRule::get_Profiles Specifica i profili a cui appartiene la regola. (Get) |
| INetFwRule::get_Protocol Specifica il protocollo IP di questa regola. (Get) |
| INetFwRule::get_RemoteAddresses Specifica l'elenco di indirizzi remoti per questa regola. (Get) |
| INetFwRule::get_RemotePorts Specifica l'elenco di porte remote per questa regola. (Get) |
| INetFwRule::get_ServiceName Specifica la proprietà del nome del servizio dell'applicazione. (Get) |
| INetFwRule::p ut_Action Specifica l'azione per una regola o un'impostazione predefinita. (INetFwRule.put_Action) |
| INetFwRule::p ut_ApplicationName Specifica il nome descrittivo dell'applicazione a cui si applica questa regola. (Put) |
| INetFwRule::p ut_Description Specifica la descrizione di questa regola. (Put) |
| INetFwRule::p ut_Direction Specifica la direzione del traffico per cui viene applicata la regola. (Put) |
| INetFwRule::p ut_EdgeTraversal Indica se l'attraversamento dei bordi è abilitato o disabilitato per questa regola. (Put) |
| INetFwRule::p ut_Enabled Abilita o disabilita una regola. (Put) |
| INetFwRule::p ut_Grouping Specifica il gruppo a cui appartiene una singola regola. (Put) |
| INetFwRule::p ut_IcmpTypesAndCodes Specifica l'elenco di tipi e codici ICMP per questa regola. (Put) |
| INetFwRule::p ut_Interfaces Specifica l'elenco di interfacce per cui viene applicata la regola. (Put) |
| INetFwRule::p ut_InterfaceTypes Specifica l'elenco di tipi di interfaccia per cui viene applicata la regola. (Put) |
| INetFwRule::p ut_LocalAddresses Specifica l'elenco di indirizzi locali per questa regola. (Put) |
| INetFwRule::p ut_LocalPorts Specifica l'elenco delle porte locali per questa regola. (Put) |
| INetFwRule::p ut_Name Specifica il nome descrittivo di questa regola. (Put) |
| INetFwRule::p ut_Profiles Specifica i profili a cui appartiene la regola. (Put) |
| INetFwRule::p ut_Protocol Specifica il protocollo IP di questa regola. (Put) |
| INetFwRule::p ut_RemoteAddresses Specifica l'elenco di indirizzi remoti per questa regola. (Put) |
| INetFwRule::p ut_RemotePorts Specifica l'elenco delle porte remote per questa regola. (Put) |
| INetFwRule::p ut_ServiceName Specifica la proprietà nome servizio dell'applicazione. (Put) |
Commenti
Ogni volta che si modifica una proprietà di una regola, Windows Firewall esegue il commit della regola e la verifica per la correttezza. Di conseguenza, quando si modifica una regola, è necessario eseguire i passaggi in un ordine specifico. Ad esempio, se si aggiunge una regola ICMP, è prima necessario impostare il protocollo su ICMP, quindi aggiungere la regola. Se questi passaggi vengono eseguiti nell'ordine opposto, si verifica un errore e la modifica viene persa.
Se si modifica una regola di porta TCP e la si converte in una regola ICMP, eliminare prima la porta, modificare il protocollo da TCP a ICMP e quindi aggiungere la regola.
Per recuperare e modificare le regole esistenti, è necessario recuperare le istanze di questa interfaccia tramite INetFwRules. Tutte le modifiche di configurazione vengono eseguite immediatamente.
Quando si accede alle proprietà di una regola, tenere presente che potrebbe verificarsi un ritardo di tempo ridotto prima che venga applicata una regola appena aggiunta.
Le proprietà vengono usate per creare regole del firewall. Molte delle proprietà possono essere usate per creare regole firewall molto specifiche.
| Proprietà | Tipo e formato | Vincoli |
|---|---|---|
| Nome | Cancella stringa di testo. | Obbligatorio. La stringa non deve contenere un "|" e non deve essere "all". |
| Descrizione | Cancella stringa di testo. | facoltativo. La stringa non deve contenere un oggetto "|". |
| Raggruppamento | Stringa nel formato "@<dll name>, <resource string identifier>". | Obbligatorio. |
| Enabled | Boolean (VARIANT_BOOLEAN). | facoltativo. Impostazione predefinita su false (VARIANT_FALSE) se non viene specificato nulla. |
| ApplicationName | Cancella stringa di testo. | facoltativo. |
| Servicename | Cancella stringa di testo. | facoltativo. |
| LocalPorts | Cancellare la stringa di testo contenente un elenco di numeri di porta. "RPC" è un valore accettabile. | facoltativo. |
| RemotePorts | Cancellare la stringa di testo contenente un elenco di numeri di porta. | facoltativo. |
| LocalAddresses | Cancellare la stringa di testo contenente un elenco di indirizzi IPv4 e IPv6 separati da virgole. I valori di intervallo e"*"sono accettabili in questo elenco. | facoltativo. |
| RemoteAddresses | Cancellare la stringa di testo contenente un elenco di indirizzi IPv4 e IPv6 separati da virgole. I valori di intervallo e"*"sono accettabili in questo elenco. | facoltativo. |
| Protocollo | Numero. | facoltativo. |
| put_Profiles | Valore stringa nel formato "type, code". È possibile includere più tipi e codici nella stringa separando ogni coppia con ";". | facoltativo. |
| Interfacce | Matrice di stringhe contenenti i nomi descrittivi delle interfacce. | facoltativo. |
| Interfacetypes | Valore stringa. È possibile includere più tipi di interfaccia nella stringa separando ogni valore con un oggetto ",". I valori accettabili sono "RemoteAccess", "Wireless", "Lan" e "All". | facoltativo. |
| Direzione | Enumerazione. | facoltativo. |
| Azione | Enumerazione. | facoltativo. |
| EdgeTraversal | Boolean (VARIANT_BOOLEAN). | facoltativo. |
| Profili | Enumerazione. | facoltativo. |
Per altre informazioni su ogni proprietà, vedere l'argomento corrispondente.
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 |