Fungsi RasGetSubEntryHandleA (ras.h)

Artikel
03/15/2023

Fungsi RasGetSubEntryHandle mengambil handel koneksi untuk subentri tertentu dari koneksi multilink.

Sintaks

DWORD RasGetSubEntryHandleA(
  [in]  HRASCONN   unnamedParam1,
  [in]  DWORD      unnamedParam2,
  [out] LPHRASCONN unnamedParam3
);

Parameter

[in] unnamedParam1

Menentukan handel koneksi HRASCONN yang dikembalikan oleh fungsi RasDial untuk entri buku telepon multilink.

[in] unnamedParam2

Menentukan indeks subentri yang valid untuk entri buku telepon.

[out] unnamedParam3

Penunjuk ke variabel HRASCONN yang menerima handel koneksi yang mewakili koneksi subentri.

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 koneksi hRasConn tidak mewakili entri buku telepon yang terhubung.
ERROR_PORT_NOT_OPEN	Parameter hRasConn dan dwSubEntry valid, tetapi subentri yang ditentukan tidak tersambung.
ERROR_NO_MORE_ITEMS	Nilai yang ditentukan oleh dwSubEntry melebihi jumlah maksimum subentri untuk entri buku telepon.

Keterangan

Handel koneksi yang ditentukan dalam parameter hRasConn mengacu pada seluruh koneksi multilink, tetapi handel koneksi yang dikembalikan dalam parameter *lphRasConn hanya mengacu pada koneksi subentri. Gunakan handel koneksi subentri dalam fungsi apa pun yang menerima parameter hRasConn , termasuk fungsi RasHangUp, RasGetConnectStatus, dan RasGetProjectionInfoEx . Informasi proyeksi yang dikembalikan oleh RasGetProjectionInfo untuk entri multilink sama untuk setiap handel koneksi subentry seperti untuk handel koneksi utama.

Anda dapat memanggil RasHangUp pada handel yang dikembalikan oleh RasGetSubEntryHandle untuk mengakhiri satu tautan dalam koneksi multi-tautan. Namun, 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 RasGetSubEntryHandle 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