Fungsi RasConnectionNotificationA (ras.h)

  • Artikel

Fungsi RasConnectionNotification menentukan objek peristiwa yang diatur sistem ke status tersinyal saat koneksi RAS dibuat atau dihentikan.

Sintaks

DWORD RasConnectionNotificationA(
  [in] HRASCONN unnamedParam1,
  [in] HANDLE   unnamedParam2,
  [in] DWORD    unnamedParam3
);

Parameter

[in] unnamedParam1

Handel ke koneksi RAS yang menerima pemberitahuan. Ini bisa menjadi handel yang dikembalikan oleh fungsi RasDial atau RasEnumConnections . Jika parameter ini INVALID_HANDLE_VALUE, pemberitahuan diterima untuk semua koneksi RAS pada klien lokal.

[in] unnamedParam2

Menentukan handel objek peristiwa. Gunakan fungsi CreateEvent untuk membuat objek peristiwa.

[in] unnamedParam3

Menentukan peristiwa RAS yang menyebabkan sistem memberi sinyal objek peristiwa yang ditentukan oleh parameter hEvent . Parameter ini adalah kombinasi dari nilai berikut.

Nilai Makna
RASCN_Connection
 Jika hrasconnINVALID_HANDLE_VALUE, hEvent akan disinyalir saat koneksi RAS dibuat.
RASCN_Disconnection
 hEvent disinyalir ketika koneksi hrasconn dihentikan. Jika hrasconn adalah koneksi multilink, peristiwa akan disinyalir ketika semua subentri terputus. Jika hrasconnINVALID_HANDLE_VALUE, peristiwa akan disinyalir ketika koneksi RAS dihentikan.
RASCN_BandwidthAdded
 Windows NT: Jika hrasconn adalah handel ke koneksi multilink gabungan, hEvent akan disinyalir saat subentri tersambung.
RASCN_BandwidthRemoved
 Windows NT: Jika hrasconn adalah handel ke koneksi multilink gabungan, hEvent diberi sinyal ketika subentri terputus.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Keterangan

Untuk menentukan kapan objek peristiwa diberi sinyal, gunakan salah satu fungsi tunggu.

Saat peristiwa diberi sinyal, gunakan fungsi RAS lainnya, seperti RasEnumConnections, untuk mendapatkan informasi selengkapnya tentang koneksi RAS yang dibuat atau dihentikan.

Catatan

Header ras.h mendefinisikan RasConnectionNotification 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

Lihat juga

CreateEvent

RasEnumConnections

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Layanan Akses Jarak Jauh