Antarmuka INetFwRule (netfw.h)
Antarmuka INetFwRule menyediakan akses ke properti aturan.
Warisan
Antarmuka INetFwRule mewarisi dari antarmuka IDispatch . INetFwRule juga memiliki jenis anggota ini:
Metode
Antarmuka INetFwRule memiliki metode ini.
| INetFwRule::get_Action Menentukan tindakan untuk aturan atau pengaturan default. (INetFwRule.get_Action) |
| INetFwRule::get_ApplicationName Menentukan nama aplikasi yang mudah diingat tempat aturan ini berlaku. (Dapatkan) |
| INetFwRule::get_Description Menentukan deskripsi aturan ini. (Dapatkan) |
| INetFwRule::get_Direction Menentukan arah lalu lintas yang aturannya berlaku. (Dapatkan) |
| INetFwRule::get_EdgeTraversal Menunjukkan apakah traversal tepi diaktifkan atau dinonaktifkan untuk aturan ini. (Dapatkan) |
| INetFwRule::get_Enabled Mengaktifkan atau menonaktifkan aturan. (Dapatkan) |
| INetFwRule::get_Grouping Menentukan grup tempat aturan individual berada. (Dapatkan) |
| INetFwRule::get_IcmpTypesAndCodes Menentukan daftar jenis dan kode ICMP untuk aturan ini. (Dapatkan) |
| INetFwRule::get_Interfaces Menentukan daftar antarmuka yang aturannya berlaku. (Dapatkan) |
| INetFwRule::get_InterfaceTypes Menentukan daftar jenis antarmuka yang aturannya berlaku. (Dapatkan) |
| INetFwRule::get_LocalAddresses Menentukan daftar alamat lokal untuk aturan ini. (Dapatkan) |
| INetFwRule::get_LocalPorts Menentukan daftar port lokal untuk aturan ini. (Dapatkan) |
| INetFwRule::get_Name Menentukan nama yang mudah diingat dari aturan ini. (Dapatkan) |
| INetFwRule::get_Profiles Menentukan profil tempat aturan berada. (Dapatkan) |
| INetFwRule::get_Protocol Menentukan protokol IP aturan ini. (Dapatkan) |
| INetFwRule::get_RemoteAddresses Menentukan daftar alamat jarak jauh untuk aturan ini. (Dapatkan) |
| INetFwRule::get_RemotePorts Menentukan daftar port jarak jauh untuk aturan ini. (Dapatkan) |
| INetFwRule::get_ServiceName Menentukan properti nama layanan aplikasi. (Dapatkan) |
| INetFwRule::p ut_Action Menentukan tindakan untuk aturan atau pengaturan default. (INetFwRule.put_Action) |
| INetFwRule::p ut_ApplicationName Menentukan nama aplikasi yang mudah diingat tempat aturan ini berlaku. (Put) |
| INetFwRule::p ut_Description Menentukan deskripsi aturan ini. (Put) |
| INetFwRule::p ut_Direction Menentukan arah lalu lintas yang aturannya berlaku. (Put) |
| INetFwRule::p ut_EdgeTraversal Menunjukkan apakah traversal tepi diaktifkan atau dinonaktifkan untuk aturan ini. (Put) |
| INetFwRule::p ut_Enabled Mengaktifkan atau menonaktifkan aturan. (Put) |
| INetFwRule::p ut_Grouping Menentukan grup tempat aturan individual berada. (Put) |
| INetFwRule::p ut_IcmpTypesAndCodes Menentukan daftar jenis dan kode ICMP untuk aturan ini. (Put) |
| INetFwRule::p ut_Interfaces Menentukan daftar antarmuka yang aturannya berlaku. (Put) |
| INetFwRule::p ut_InterfaceTypes Menentukan daftar jenis antarmuka yang aturannya berlaku. (Put) |
| INetFwRule::p ut_LocalAddresses Menentukan daftar alamat lokal untuk aturan ini. (Put) |
| INetFwRule::p ut_LocalPorts Menentukan daftar port lokal untuk aturan ini. (Put) |
| INetFwRule::p ut_Name Menentukan nama yang mudah diingat dari aturan ini. (Put) |
| INetFwRule::p ut_Profiles Menentukan profil tempat aturan berada. (Put) |
| INetFwRule::p ut_Protocol Menentukan protokol IP aturan ini. (Put) |
| INetFwRule::p ut_RemoteAddresses Menentukan daftar alamat jarak jauh untuk aturan ini. (Put) |
| INetFwRule::p ut_RemotePorts Menentukan daftar port jarak jauh untuk aturan ini. (Put) |
| INetFwRule::p ut_ServiceName Menentukan properti nama layanan aplikasi. (Put) |
Keterangan
Setiap kali Anda mengubah properti aturan, Windows Firewall menerapkan aturan dan memverifikasinya untuk kebenaran. Akibatnya, saat mengedit aturan, Anda harus melakukan langkah-langkah dalam urutan tertentu. Misalnya, jika Anda menambahkan aturan ICMP, Anda harus terlebih dahulu mengatur protokol ke ICMP, lalu menambahkan aturan. Jika langkah-langkah ini diambil dalam urutan yang berlawanan, kesalahan terjadi dan perubahan hilang.
Jika Anda mengedit aturan port TCP dan mengonversinya menjadi aturan ICMP, pertama-tama hapus port, ubah protokol dari TCP ke ICMP, lalu tambahkan aturan.
Untuk mengambil dan memodifikasi aturan yang ada, instans antarmuka ini harus diambil melalui INetFwRules. Semua perubahan konfigurasi segera terjadi.
Saat mengakses properti aturan, perlu diingat bahwa mungkin ada jeda waktu kecil sebelum aturan yang baru ditambahkan diterapkan.
Properti digunakan untuk membuat aturan firewall. Banyak properti dapat digunakan untuk membuat aturan firewall yang sangat spesifik.
| Properti | Jenis dan format | Batasan |
|---|---|---|
| Nama | Bersihkan string teks. | Wajib diisi. String tidak boleh berisi "|" dan tidak boleh "semua". |
| Deskripsi | Bersihkan string teks. | Opsional. String tidak boleh berisi "|". |
| Pengelompokan | String dalam format "@<dll name>, <resource string identifier>". | Wajib diisi. |
| Aktif | Boolean (VARIANT_BOOLEAN). | Opsional. Default ke false (VARIANT_FALSE) jika tidak ada yang ditentukan. |
| ApplicationName | Bersihkan string teks. | Pilihan. |
| ServiceName | Bersihkan string teks. | Opsional. |
| LocalPorts | Hapus string teks yang berisi daftar nomor port. "RPC" adalah nilai yang dapat diterima. | Pilihan. |
| RemotePorts | Hapus string teks yang berisi daftar nomor port. | Pilihan. |
| LocalAddresses | Hapus string teks yang berisi daftar alamat IPv4 dan IPv6 yang dipisahkan oleh koma. Nilai rentang dan"*"dapat diterima dalam daftar ini. | Pilihan. |
| RemoteAddresses | Hapus string teks yang berisi daftar alamat IPv4 dan IPv6 yang dipisahkan oleh koma. Nilai rentang dan"*"dapat diterima dalam daftar ini. | Pilihan. |
| Protokol | Nomor. | Opsional. |
| put_Profiles | Nilai string dalam format "type, code". Beberapa jenis dan kode dapat disertakan dalam string dengan memisahkan setiap pasangan dengan ";". | Opsional. |
| Antarmuka | Array string yang berisi nama antarmuka yang mudah diingat. | Opsional. |
| InterfaceTypes | Nilai string. Beberapa jenis antarmuka dapat disertakan dalam string dengan memisahkan setiap nilai dengan ",". Nilai yang dapat diterima adalah "RemoteAccess", "Wireless", "Lan", dan "All". | Opsional. |
| Arah | Enumerasi. | Pilihan. |
| Tindakan | Enumerasi. | Pilihan. |
| EdgeTraversal | Boolean (VARIANT_BOOLEAN). | Opsional. |
| Profil | Enumerasi. | Pilihan. |
Untuk informasi tambahan tentang setiap properti, silakan lihat topik yang sesuai.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | netfw.h |