Metode SetGateways dari kelas Win32_NetworkAdapterConfiguration
Metode kelas SetGatewaysWMI menentukan daftar gateway untuk paket perutean ke subnet yang berbeda dari subnet yang tersambung dengan adaptor jaringan.
Topik ini menggunakan sintaksIs Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.
Sintaks
uint32 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
Parameter
-
DefaultIPGateway [in]
-
Daftar alamat IP ke gateway tempat paket jaringan dirutekan.
-
GatewayCostMetric [in, opsional]
-
Menetapkan nilai yang berkisar antara 1 hingga 9999, yang digunakan untuk menghitung rute tercepat dan paling dapat diandalkan. Nilai parameter ini sesuai dengan nilai dalam parameter DefaultIPGateway . Nilai default untuk gateway adalah 1.
Nilai hasil
Mengembalikan nilai 0 (nol) untuk penyelesaian yang berhasil saat reboot tidak diperlukan, 1 (satu) untuk penyelesaian yang berhasil saat reboot diperlukan, dan nilai lain jika ada kesalahan. Untuk informasi selengkapnya tentang kode kesalahan, lihat Konstanta Kesalahan WMI atau WbemErrorEnum. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
-
Penyelesaian berhasil, tidak diperlukan boot ulang
-
0
-
Penyelesaian berhasil, reboot diperlukan
-
1
-
Metode tidak didukung pada platform ini
-
64
Metode tidak didukung ketika NIC berada dalam mode DHCP.
-
Kegagalan tidak diketahui
-
65
-
Subnet mask tidak valid
-
66
-
Terjadi kesalahan saat memproses Instans yang dikembalikan
-
67
-
Parameter input tidak valid
-
68
-
Lebih dari 5 gateway ditentukan
-
69
-
Alamat IP tidak valid
-
70
-
Alamat IP gateway tidak valid
-
71
-
Terjadi kesalahan saat mengakses Registri untuk informasi yang diminta
-
72
-
Nama domain tidak valid
-
73
-
Nama host tidak valid
-
74
-
Tidak ada server WINS primer/sekunder yang ditentukan
-
75
-
File tidak valid
-
76
-
Jalur sistem tidak valid
-
77
-
Penyalinan file gagal
-
78
-
Parameter keamanan tidak valid
-
79
-
Tidak dapat mengonfigurasi layanan TCP/IP
-
80
-
Tidak dapat mengonfigurasi layanan DHCP
-
81
-
Tidak dapat memperbarui sewa DHCP
-
82
-
Tidak dapat melepaskan sewa DHCP
-
83
-
IP tidak diaktifkan pada adaptor
-
84
-
IPX tidak diaktifkan pada adaptor
-
85
-
Kesalahan batas nomor bingkai/jaringan
-
86
-
Jenis bingkai tidak valid
-
87
-
Nomor jaringan tidak valid
-
88
-
Nomor jaringan duplikat
-
89
-
Parameter di luar batas
-
90
-
Akses ditolak
-
91
-
Kehabisan memori
-
92
-
Sudah ada
-
93
-
Jalur, file, atau objek tidak ditemukan
-
94
-
Tidak dapat memberi tahu layanan
-
95
-
Tidak dapat memberi tahu layanan DNS
-
96
-
Antarmuka tidak dapat dikonfigurasi
-
97
-
Tidak semua sewa DHCP dapat dirilis/diperpanjang
-
98
-
DHCP tidak diaktifkan pada adaptor
-
100
-
Lainnya
-
101 4294967295
Keterangan
Metode ini hanya berfungsi ketika Kartu Antarmuka Jaringan (NIC) berada dalam mode IP statis.
Untuk menghapus gateway, atur gateway Anda ke IP yang sama dengan yang Anda gunakan di EnableStatic.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|