Metode SetGateways dari kelas Win32_NetworkAdapterConfiguration

Artikel
11/10/2023

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

Penyelesaian berhasil, reboot diperlukan

Metode tidak didukung pada platform ini

Metode tidak didukung ketika NIC berada dalam mode DHCP.

Kegagalan tidak diketahui

Subnet mask tidak valid

Terjadi kesalahan saat memproses Instans yang dikembalikan

Parameter input tidak valid

Lebih dari 5 gateway ditentukan

Alamat IP tidak valid

Alamat IP gateway tidak valid

Terjadi kesalahan saat mengakses Registri untuk informasi yang diminta

Nama domain tidak valid

Nama host tidak valid

Tidak ada server WINS primer/sekunder yang ditentukan

File tidak valid

Jalur sistem tidak valid

Penyalinan file gagal

Parameter keamanan tidak valid

Tidak dapat mengonfigurasi layanan TCP/IP

Tidak dapat mengonfigurasi layanan DHCP

Tidak dapat memperbarui sewa DHCP

Tidak dapat melepaskan sewa DHCP

IP tidak diaktifkan pada adaptor

IPX tidak diaktifkan pada adaptor

Kesalahan batas nomor bingkai/jaringan

Jenis bingkai tidak valid

Nomor jaringan tidak valid

Nomor jaringan duplikat

Parameter di luar batas

Akses ditolak

Kehabisan memori

Sudah ada

Jalur, file, atau objek tidak ditemukan

Tidak dapat memberi tahu layanan

Tidak dapat memberi tahu layanan DNS

Antarmuka tidak dapat dikonfigurasi

Tidak semua sewa DHCP dapat dirilis/diperpanjang

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	CIMWin32.mof
DLL	CIMWin32.dll