Fungsi EnumMonitors

Artikel
06/12/2023

Fungsi EnumMonitors mengambil informasi tentang monitor port yang diinstal pada server yang ditentukan.

Sintaks

BOOL EnumMonitors(
  _In_  LPTSTR  pName,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pMonitors,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded,
  _Out_ LPDWORD pcReturned
);

Parameter

pName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama server tempat monitor berada. Jika parameter ini NULL, monitor lokal akan dijumlahkan.

Level [in]

Versi struktur yang ditunjukkan oleh pMonitors.

Nilai ini bisa 1 atau 2.

pMonitors [out]

Penunjuk ke buffer yang menerima array struktur. Buffer harus cukup besar untuk menyimpan string yang dirujuk oleh anggota struktur.

Untuk menentukan ukuran buffer yang diperlukan, panggil EnumMonitors dengan cbBuf diatur ke nol. EnumMonitors gagal, GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, dan parameter pcbNeeded mengembalikan ukuran, dalam byte, dari buffer yang diperlukan untuk menyimpan array struktur dan datanya.

Buffer menerima array struktur MONITOR_INFO_1 jika Level adalah 1, atau struktur MONITOR_INFO_2 jika Level adalah 2.

cbBuf [in]

Ukuran, dalam byte, dari buffer yang ditunjukkan oleh pMonitors.

pcbNeeded [out]

Penunjuk ke variabel yang menerima jumlah byte yang disalin jika fungsi berhasil atau jumlah byte yang diperlukan jika cbBuf terlalu kecil.

pcReturned [out]

Penunjuk ke variabel yang menerima jumlah struktur yang dikembalikan dalam buffer yang ditunjukkan oleh pMonitors.

Mengembalikan 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 dikembalikan. 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.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winspool.h (termasuk Windows.h)
Pustaka	Winspool.lib
DLL	Winspool.drv
Nama Unicode dan ANSI	EnumMonitorsW (Unicode) dan EnumMonitorsA (ANSI)

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
MONITOR_INFO_1
MONITOR_INFO_2

Bagikan melalui