Fungsi Pemberitahuan

[Fungsi peringatan 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 contoh tertentu dari proses, kemunculan, atau status perangkat keras seperti yang ditentukan oleh aplikasi. Fungsi pemberitahuan memungkinkan aplikasi untuk menunjukkan kapan peristiwa yang telah ditentukan 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 memberi tahu 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 disk drive, aplikasi akan berisiko 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 dengan 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 dengan 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 dengan 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 Windows Management Instrumentation (WMI) SDK untuk pemberitahuan peristiwa. Untuk informasi selengkapnya tentang platform yang mendukung model peristiwa WMI, lihat Infrastruktur WMI dan Peristiwa Pemantauan dalam dokumentasi WMI.