Fungsi RasHangUpA (ras.h)

Artikel
03/01/2024

Fungsi RasHangUp mengakhiri koneksi akses jarak jauh. Koneksi ditentukan dengan handel koneksi RAS. Fungsi ini merilis semua sumber daya RASAPI32.DLL yang terkait dengan handel.

Sintaks

DWORD RasHangUpA(
  [in] HRASCONN unnamedParam1
);

Parameter

[in] unnamedParam1

Menentukan koneksi akses jarak jauh yang akan dihentikan. Ini adalah handel yang dikembalikan dari panggilan sebelumnya ke RasDial atau RasEnumConnections.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut atau nilai dari Kode Kesalahan Perutean dan Akses Jarak Jauh atau Winerror.h.

Nilai	Makna
ERROR_INVALID_HANDLE	Handel yang ditentukan dalam hrasconn tidak valid.

Keterangan

Koneksi dihentikan meskipun panggilan RasDial belum selesai.

Setelah panggilan ini, handel hrasconn tidak dapat digunakan lagi.

Aplikasi tidak boleh memanggil RasHangUp dan kemudian segera keluar. Komputer status koneksi membutuhkan waktu untuk mengakhiri dengan benar. Jika sistem menghentikan mesin status secara prematur, komputer status dapat gagal menutup port dengan benar, meninggalkan port dalam keadaan tidak konsisten. Selain itu, upaya segera untuk menggunakan koneksi yang sama mungkin gagal meninggalkan koneksi tidak dapat digunakan. Cara sederhana untuk menghindari masalah ini adalah dengan memanggil Sleep (3000) setelah kembali dari RasHangUp; setelah jeda itu, aplikasi dapat keluar. Cara yang lebih responsif untuk menghindari masalah ini adalah, setelah kembali dari RasHangUp, untuk memanggil RasGetConnectStatus(hrasconn) dan Sleep(0) dalam perulangan hingga RasGetConnectStatus kembali ERROR_INVALID_HANDLE.

Anda dapat memanggil RasHangUp pada handel yang dikembalikan oleh RasGetSubEntryHandle untuk mengakhiri satu tautan dalam koneksi multi-tautan. Namun, dalam hal ini, Anda tidak dapat menggunakan RasGetConnectStatus untuk menentukan apakah tautan dihentikan; RasGetConnectStatus mungkin tidak mengembalikan ERROR_INVALID_HANDLE meskipun tautan berhasil dihentikan.

Catatan

Header ras.h mendefinisikan RasHangUp sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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	ras.h
Pustaka	Rasapi32.lib
DLL	Rasapi32.dll