Fungsi UnenableRouter (iphlpapi.h)
Fungsi UnenableRouter mengurangi jumlah referensi yang melacak jumlah permintaan untuk mengaktifkan penerusan IPv4. Ketika jumlah referensi ini mencapai nol, UnenableRouter menonaktifkan penerusan IPv4 di komputer lokal.
Sintaks
IPHLPAPI_DLL_LINKAGE DWORD UnenableRouter(
OVERLAPPED *pOverlapped,
[out, optional] LPDWORD lpdwEnableCount
);
Parameter
pOverlapped
Penunjuk ke struktur yang TUMPANG TINDIH . Struktur ini harus sama dengan yang digunakan dalam panggilan ke fungsi EnableRouter .
[out, optional] lpdwEnableCount
Penunjuk opsional ke variabel DWORD . Variabel ini menerima jumlah referensi yang tersisa.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.
Jika fungsi gagal, gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.
Keterangan
Fungsi UnenableRouter khusus untuk penerusan IPv4. Setiap panggilan yang dilakukan proses ke UnenableRouter harus sesuai dengan panggilan sebelumnya ke EnableRouter dengan proses yang sama. Sistem mengembalikan kesalahan pada panggilan asing ke UnenableRouter. Akibatnya, proses tertentu tidak dapat mengurangi jumlah referensi yang melacak jumlah permintaan untuk mengaktifkan penerusan IPv4 untuk proses lain. Selain itu, jika penerusan IPv4 diaktifkan oleh proses tertentu, penerusan IPv4 tidak dapat dinonaktifkan oleh proses yang berbeda.
Tidak mungkin untuk secara akurat menentukan jumlah referensi yang melacak jumlah permintaan untuk mengaktifkan penerusan IPv4 karena mungkin ada permintaan EnableRouter lain yang luar biasa. Jadi nilai yang dikembalikan untuk parameter lpdwEnableCount selalu merupakan hitungan besar yang sama dengan ULONG_MAX/2.
Jika proses yang memanggil EnableRouter berakhir tanpa memanggil UnenableRouter, sistem mengurangi jumlah referensi yang melacak permintaan untuk mengaktifkan penerusan IPv4 seolah-olah proses telah memanggil UnenableRouter.
Setelah memanggil UnenableRouter, gunakan panggilan CloseHandle untuk menutup handel ke objek peristiwa dalam struktur YANG TUMPANG TINDIH .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | iphlpapi.h |
| Pustaka | Iphlpapi.lib |
| DLL | Iphlpapi.dll |