Fungsi GetPrintProcessorDirectory

Artikel
06/12/2023

Fungsi GetPrintProcessorDirectory mengambil jalur ke direktori prosesor cetak pada server yang ditentukan.

Sintaks

BOOL GetPrintProcessorDirectory(
  _In_  LPTSTR  pName,
  _In_  LPTSTR  pEnvironment,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pPrintProcessorInfo,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

Parameter

pName [in]: Penunjuk ke string yang dihentikan null yang menentukan nama server. Jika parameter ini NULL, jalur lokal dikembalikan.
pEnvironment [in]: Penunjuk ke string yang dihentikan null yang menentukan lingkungan (misalnya, Windows x86, Windows IA64, atau Windows x64). Jika parameter ini NULL, lingkungan aplikasi panggilan dan komputer klien saat ini (bukan dari aplikasi tujuan dan server cetak) digunakan.
Level [in]: Tingkat struktur. Nilai ini harus 1.
pPrintProcessorInfo [out]: Penunjuk ke buffer yang menerima jalur. Perhatikan bahwa, untuk sistem operasi sebelum Windows Server 2003 SP 1, jalur dalam format lokal untuk server, bukan format jarak jauh yang sebenarnya. Misalnya, jalur diberikan sebagai "%Windir%\System32\Spool\Prtprocs\%Environment%" alih-alih "\\ServerName\Print$\Prtprocs\%Environment%", bahkan ketika dipanggil untuk server jarak jauh. Untuk sistem operasi Windows Server 2003 SP 1 dan yang lebih baru, jalur jarak jauh yang benar dikembalikan.
cbBuf [in]: Ukuran buffer yang diacu oleh pPrintProcessorInfo.
pcbNeeded [out]: Penunjuk ke nilai yang menentukan jumlah byte yang disalin jika fungsi berhasil, atau jumlah byte yang diperlukan jika cbBuf terlalu kecil.

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

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	GetPrintProcessorDirectoryW (Unicode) dan GetPrintProcessorDirectoryA (ANSI)

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
AddPrintProcessor

Bagikan melalui