Fungsi GetPrinterDriverDirectory
Fungsi GetPrinterDriverDirectory mengambil jalur direktori driver printer.
Sintaks
BOOL GetPrinterDriverDirectory(
_In_ LPTSTR pName,
_In_ LPTSTR pEnvironment,
_In_ DWORD Level,
_Out_ LPBYTE pDriverDirectory,
_In_ DWORD cbBuf,
_Out_ LPDWORD pcbNeeded
);
Parameter
-
pName [in]
-
Penunjuk ke string yang dihentikan null yang menentukan nama server tempat driver printer berada. Jika parameter ini NULL, jalur direktori driver lokal akan diambil.
-
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 aplikasi tujuan dan server cetak) digunakan.
-
Level [in]
-
Tingkat struktur. Nilai ini harus 1.
-
pDriverDirectory [out]
-
Penunjuk ke buffer yang menerima jalur.
-
cbBuf [in]
-
Ukuran buffer tempat pDriverDirectory menunjuk.
-
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 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 |
|
| Pustaka |
|
| DLL |
|
| Nama Unicode dan ANSI |
GetPrinterDriverDirectoryW (Unicode) dan GetPrinterDriverDirectoryA (ANSI) |