Fungsi SHInvokePrinterCommandA (shellapi.h)
Menjalankan perintah pada objek printer.
Sintaks
BOOL SHInvokePrinterCommandA(
[in, optional] HWND hwnd,
UINT uAction,
[in] LPCSTR lpBuf1,
[in, optional] LPCSTR lpBuf2,
BOOL fModal
);
Parameter
[in, optional] hwnd
Jenis: HWND
Handel jendela induk dari jendela atau kotak dialog apa pun yang dibuat selama operasi.
uAction
Jenis: UINT
Jenis operasi printer yang akan dilakukan. Salah satu dari nilai berikut:
PRINTACTION_OPEN (0)
0x0. Buka printer yang ditentukan oleh lpBuf1. Parameter lpBuf2 diabaikan.
PRINTACTION_PROPERTIES (1)
0x1. Tampilkan halaman properti untuk printer yang ditentukan oleh lpBuf1. Parameter lpBuf2 dapat berupa NULL atau dapat memberi nama lembar properti tertentu untuk ditampilkan, baik berdasarkan nama atau angka. Jika WORDtinggi lpBuf2 bukan nol, diasumsikan bahwa parameter ini adalah penunjuk ke buffer yang berisi nama lembar yang akan dibuka. Jika tidak, lpBuf2 dipandang sebagai indeks berbasis nol dari lembar properti untuk dibuka.
PRINTACTION_NETINSTALL (2)
0x2. Instal pencetak jaringan yang ditentukan oleh lpBuf1. Parameter lpBuf2 diabaikan.
PRINTACTION_NETINSTALLLINK (3)
0x3. Buat pintasan ke pencetak jaringan yang ditentukan oleh lpBuf1. Parameter lpBuf2 menentukan drive dan jalur folder untuk membuat pintasan. Pencetak jaringan harus sudah diinstal pada komputer lokal.
PRINTACTION_TESTPAGE (4)
0x4. Cetak halaman uji pada printer yang ditentukan oleh lpBuf1. Parameter lpBuf2 diabaikan.
PRINTACTION_OPENNETPRN (5)
0x5. Buka pencetak jaringan yang ditentukan oleh lpBuf1. Parameter lpBuf2 diabaikan.
PRINTACTION_DOCUMENTDEFAULTS (6)
0x6. Tampilkan properti dokumen default untuk printer yang ditentukan oleh lpBuf1. Parameter lpBuf2 diabaikan.
PRINTACTION_SERVERPROPERTIES (7)
0x7. Tampilkan properti untuk server printer yang ditentukan oleh lpBuf1. Parameter lpBuf2 diabaikan.
[in] lpBuf1
Jenis: LPCTSTR
Penunjuk ke string yang dihentikan null yang berisi informasi tambahan untuk perintah printer. Informasi yang terkandung dalam parameter ini tergantung pada nilai uAction.
[in, optional] lpBuf2
Jenis: LPCTSTR
Penunjuk ke string yang dihentikan null yang berisi informasi tambahan untuk perintah printer. Informasi yang terkandung dalam parameter ini tergantung pada nilai uAction.
fModal
Jenis: BOOL
TRUE untuk menentukan bahwa SHInvokePrinterCommand tidak boleh kembali sampai perintah selesai; FALSE jika fungsi harus kembali segera setelah perintah diinisialisasi.
Nilai kembali
Jenis: BOOL
Mengembalikan TRUE jika berhasil; jika tidak, FALSE.
Keterangan
Ketika nama printer ditentukan oleh lpBuf1, nama bisa menjadi nama printer lokal atau server dan berbagi nama printer jaringan. Ketika menentukan nama printer jaringan, nama harus ditentukan dalam format ini:
"\\<server><shared printer name>"
Fungsi ini diimplementasikan dalam Shell versi 4.71 dan yang lebih baru. Untuk mempertahankan kompatibilitas mundur dengan versi Shell sebelumnya, fungsi ini tidak boleh digunakan secara eksplisit. Sebagai gantinya, fungsi LoadLibrary dan GetProcAddress harus digunakan untuk mendapatkan alamat fungsi.
Catatan
Header shellapi.h mendefinisikan SHInvokePrinterCommand sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional, Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | shellapi.h |
Pustaka | Shell32.lib |
DLL | Shell32.dll (versi 4.71 atau yang lebih baru) |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk