Metode IPrintCoreUI2::SetOptions (prcomoem.h)

Artikel
08/07/2023

Metode ini IPrintCoreUI2::SetOptions mengatur pengaturan fitur driver.

Sintaks

HRESULT SetOptions(
  [in]  POEMUIOBJ poemuiobj,
  [in]  DWORD     dwFlags,
  [in]  PCZZSTR   pmszFeatureOptionBuf,
  [in]  DWORD     cbIn,
  [out] PDWORD    pdwResult
);

Parameter

[in] poemuiobj

Arahkan ke konteks saat ini, struktur OEMUIOBJ .

[in] dwFlags

Menentukan apakah driver inti adalah untuk mengatasi konflik. Parameter ini harus diatur ke salah satu nilai berikut:

Nilai	Makna
SETOPTIONS_FLAG_KEEP_CONFLICT	Minta driver inti untuk tidak menyelesaikan konflik apa pun yang muncul.
SETOPTIONS_FLAG_RESOLVE_CONFLICT	Minta driver inti untuk menyelesaikan konflik apa pun yang muncul.

[in] pmszFeatureOptionBuf

Penunjuk ke buffer yang disediakan penelepon yang berisi daftar pasangan kata kunci fitur/opsi dalam format MULTI_SZ. Setiap item dalam daftar ini dipisahkan dari karakter berikutnya dengan karakter null, dan daftar dihentikan dengan dua karakter null.

[in] cbIn

Menentukan ukuran, dalam byte, dari buffer yang diacu oleh pmszFeatureOptionBuf. Ukuran ini mencakup karakter null MULTI_SZ terakhir.

[out] pdwResult

Penunjuk ke lokasi memori yang menerima salah satu nilai berikut. Konstanta ini didefinisikan dalam printoem.h.

Nilai	Makna
SETOPTIONS_RESULT_CONFLICT_REMAINED	Driver inti menemukan konflik, tetapi membiarkannya tidak terselesaikan.
SETOPTIONS_RESULT_CONFLICT_RESOLVED	Driver inti menemukan dan menyelesaikan semua konflik.
SETOPTIONS_RESULT_NO_CONFLICT	Driver inti tidak menemukan konflik.

Nilai kembali

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_NOTIMPL	Metode ini tidak didukung. Struktur jenis yang ditentukan oleh dwLevel tidak didukung.
E_INVALIDARG	Nilai dalam dwFlags salah. Buffer input (ditujukkan oleh pmszFeatureOptionBuf) tidak dalam format MULTI_SZ. Parameter poemuiobj menunjuk ke objek konteks yang tidak valid.
E_FAIL	Metode gagal

Keterangan

Metode ini hanya didukung untuk plug-in Windows XP Pscript5, bukan untuk plug-in Unidrv.

Metode ini dipanggil untuk mengatur pengaturan fitur driver menggunakan daftar pasangan kata kunci fitur/opsi. Pemanggil dapat mengakses pengaturan fitur yang dihasilkan menggunakan metode IPrintCoreUI2::GetOptions .

Jika metode ini mengembalikan nilai apa pun selain S_OK, maka metode ini tidak membuat perubahan dalam pengaturan fitur driver.

Buffer input pmszFeatureOptionBuf harus dibangun dengan cara yang sama seperti buffer output metode IPrintCoreUI2::GetOptions . Artinya, pasangan kata kunci fitur/opsi harus dalam format MULTI_SZ, dan setiap item dalam daftar dipisahkan dari karakter berikutnya dengan karakter null. Sepasang karakter null mengakhiri daftar.

Jika buffer input berisi kata kunci fitur atau kata kunci opsinya yang tidak dikenali, atau fitur dikenali tetapi tidak didukung dalam mode lengket saat ini (lihat Mengganti Driver-Supplied Halaman Lembar Properti), maka pasangan fitur/opsi diabaikan, dan opsi saat ini untuk fitur tersebut terus berlaku.

Metode ini hanya didukung untuk plug-in UI yang sepenuhnya menggantikan halaman UI standar driver inti, dan hanya didukung selama fungsi IPrintOemUI::D ocumentPropertySheets dan IPrintOemUI::D evicePropertySheets UI , dan rutinitas callback lembar properti mereka.

Untuk informasi selengkapnya, lihat Menggunakan GetOptions dan SetOptions.