Fungsi AddMonitor
Fungsi AddMonitor menginstal monitor port lokal dan menautkan file konfigurasi, data, dan pemantauan.
Sintaks
BOOL AddMonitor(
_In_ LPTSTR pName,
_In_ DWORD Level,
_In_ LPBYTE pMonitors
);
Parameter
-
pName [in]
-
Penunjuk ke string yang dihentikan null yang menentukan nama server tempat monitor harus diinstal. Untuk sistem yang hanya mendukung penginstalan lokal monitor, string ini harus NULL.
-
Level [in]
-
Versi struktur yang ditunjukkan pMonitors . Nilai ini harus 2.
-
pMonitors [in]
-
Penunjuk ke struktur MONITOR_INFO_2 . Jika anggota pEnvironment dari struktur pMonitors adalah NULL, lingkungan pemanggil (klien) saat ini, bukan tujuan (server), digunakan.
Perhatikan bahwa panggilan akan gagal jika lingkungan tidak cocok dengan lingkungan server, yaitu, Anda hanya dapat menambahkan monitor yang ditulis untuk arsitektur server.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Catatan
Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera kembali. Seberapa cepat fungsi ini kembali tergantung pada faktor run-time seperti status jaringan, konfigurasi server cetak, dan faktor implementasi driver printer yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.
Pemanggil harus memiliki SeLoadDriverPrivilege.
Sebelum aplikasi memanggil fungsi AddMonitor , semua file yang diperlukan oleh monitor harus disalin ke direktori SYSTEM32.
Untuk menentukan monitor port yang saat ini diinstal, panggil fungsi EnumMonitors .
Untuk menghapus monitor yang ditambahkan oleh AddMonitor, panggil fungsi DeleteMonitor .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Header |
|
Pustaka |
|
DLL |
|
Nama Unicode dan ANSI |
AddMonitorW (Unicode) dan AddMonitorA (ANSI) |