Fungsi Pemberitahuan

[Fungsi pemberitahuan tidak didukung pada Windows Vista karena layanan peringatan dan messenger tidak didukung.]

Fungsi pemberitahuan manajemen jaringan memberi tahu program layanan jaringan dan aplikasi peristiwa jaringan. Peristiwa adalah instans tertentu dari proses, kemunculan, atau status perangkat keras seperti yang didefinisikan oleh aplikasi. Fungsi pemberitahuan memungkinkan aplikasi untuk menunjukkan kapan peristiwa yang telah ditentukan sebelumnya terjadi.

Windows Server 2003: Layanan pemberitahuan dan messenger dinonaktifkan secara default pada Windows Server 2003. Anda harus mengaktifkan kembali layanan sebelum memanggil fungsi Pemberitahuan manajemen jaringan atau fungsi Pesan manajemen jaringan.

Fungsi pemberitahuan tercantum berikut.

Fungsi Deskripsi
NetAlertRaise Memberi tahu semua klien terdaftar bahwa peristiwa tertentu telah terjadi.
NetAlertRaiseEx Menyederhanakan pemberitahuan kepada klien terdaftar bahwa peristiwa tertentu telah terjadi, karena, tidak seperti NetAlertRaise, NetAlertRaiseEx tidak memerlukan struktur STD_ALERT .

 

Layanan pemberitahuan harus berjalan di komputer klien saat Anda memanggil fungsi NetAlertRaise atau fungsi NetAlertRaiseEx . Jika layanan tidak berjalan, fungsi gagal dengan ERROR_FILE_NOT_FOUND. Layanan pemberitahuan pada klien memanggil fungsi NetMessageBufferSend untuk mengirim informasi ke penerima.

Aplikasi, layanan jaringan, dan komponen jaringan internal menggunakan fungsi pemberitahuan manajemen jaringan untuk meningkatkan pemberitahuan, memberi tahu berbagai aplikasi atau pengguna ketika jenis peristiwa tertentu terjadi. Fungsi kategori pemberitahuan, jenis data, struktur, dan konstanta ditentukan dalam LMCONS. H, LMERR. H, dan LMALERT. File header H. Untuk mengakses definisi ini, tentukan konstanta INCL_NETERRORS dan INCL_NETALERT, dan sertakan file header LM.H.

The LMALERT. File H telah menentukan kelas pemberitahuan berikut (jenis peristiwa jaringan) untuk mengirim pemberitahuan:

  • Peristiwa jaringan yang memerlukan bantuan administratif
  • Penambahan entri ke file log kesalahan
  • Penerimaan pesan siaran oleh pengguna atau aplikasi
  • Penyelesaian pekerjaan cetak
  • Penggunaan aplikasi atau sumber daya tertentu oleh pengguna

Anda dapat menentukan kelas pemberitahuan lain untuk aplikasi jaringan sesuai kebutuhan. Misalnya, jika aplikasi di server secara rutin menulis data dalam jumlah besar ke drive disk, aplikasi menjalankan risiko mengisi disk. Dalam hal ini, Anda mungkin ingin menambahkan peristiwa "tidak ada ruang disk kosong' untuk memicu pemberitahuan yang memberi tahu aplikasi untuk menjeda atau mengakhiri proses yang mengisi disk. Nama peristiwa untuk pemberitahuan dapat berupa string teks apa pun.

Saat Anda menaikkan pemberitahuan dengan panggilan ke fungsi NetAlertRaise , data pesan harus terdiri dari satu struktur header STD_ALERT , diikuti dengan data panjang tetap tambahan yang khusus untuk pemberitahuan dalam satu struktur ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO, atau USER_OTHER_INFO . Data panjang variabel tambahan dapat mengikuti struktur khusus pemberitahuan. (Panggilan ke fungsi NetAlertRaiseEx tidak memerlukan struktur STD_ALERT .) Aplikasi panggilan harus mengalokasikan memori untuk semua struktur dan data panjang variabel, dan membebaskan memori setelah panggilan kembali.

Makro berikut ini tersedia untuk digunakan dengan buffer data pemberitahuan.

Makro Deskripsi
ALERT_OTHER_INFO Mengembalikan penunjuk ke data panjang tetap yang mengikuti struktur STD_ALERT dalam pesan pemberitahuan.
ALERT_VAR_DATA Mengembalikan penunjuk ke data panjang variabel yang mengikuti data khusus pemberitahuan dalam pesan pemberitahuan.

 

Alih-alih menggunakan fungsi pemberitahuan manajemen jaringan, Anda mungkin dapat menggunakan SDK Windows Management Instrumentation (WMI) untuk pemberitahuan peristiwa. Untuk informasi selengkapnya tentang platform yang mendukung model peristiwa WMI, lihat WMI Infrastructure and Monitoring Events dalam dokumentasi WMI.