Metode IPrintCoreHelperPS::EnumConstrainedOptions (prcomoem.h)

Artikel
08/07/2023

Metode IPrintCoreHelperPS::EnumConstrainedOptions menyediakan daftar semua opsi yang dibatasi dalam fitur tertentu, berdasarkan pengaturan saat ini.

Sintaks

HRESULT EnumConstrainedOptions(
  [in, optional] IN const DEVMODE *pDevmode,
  [in]           IN DWORD         cbSize,
  [in]           IN PCSTR         pszFeatureKeyword,
  [out]          OUT PCSTR * []   pConstrainedOptionList,
  [out]          OUT DWORD        *pdwNumOptions
);

Parameter

[in, optional] pDevmode

Penunjuk ke struktur DEVMODEW . Jika pointer ini disediakan, IPrintCoreHelperPS::EnumConstrainedOptions harus menggunakan struktur DEVMODEW yang diarahkan oleh pDevmode alih-alih struktur DEVMODEW default atau saat ini. Jika metode ini dipanggil dari penyedia plug-in atau dari IPrintOemPS::D evMode, parameter ini diperlukan. Dalam sebagian besar situasi lainnya, parameter harus NULL. Ketika driver inti mengatur pDevmode ke NULL, ia memodifikasi status internalnya daripada struktur DEVMODEW yang diteruskan. Ini diperlukan selama operasi seperti penggantian UI penuh, di mana struktur DEVMODEW yang dikembalikan oleh DDI, seperti DrvDocumentPropertySheets, sedang dilayankan oleh modul UI driver inti.

[in] cbSize

Ukuran, dalam byte, dari struktur DEVMODEW yang diarahkan oleh parameter pDevmode .

[in] pszFeatureKeyword

String karakter ANSI yang berisi nama fitur.

[out] pConstrainedOptionList

Penunjuk ke array string karakter ANSI. Ketika IPrintCoreHelperPS::EnumConstrainedOptions kembali, string ini akan berisi nama semua opsi yang dibatasi dalam fitur yang ditentukan. Pemanggil tidak bertanggung jawab untuk membebaskan array atau string individual dalam array.

[out] pdwNumOptions

Penunjuk ke variabel yang menerima jumlah opsi yang dibatasi dalam array yang ditunjukkan oleh parameter pConstrainedOptionList .

Nilai kembali

IPrintCoreHelperPS::EnumConstrainedOptions harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Opsi yang dibatasi diatur untuk fitur yang ditentukan.
E_FAIL	Pemanggil memberikan informasi yang mengakibatkan permintaan yang tidak valid, seperti permintaan fitur yang tidak ada.
E_INVALIDARG	Satu atau beberapa argumen tidak valid. Nilai ini mungkin berarti bahwa fitur ini tidak didukung.
E_OUTOFMEMORY	Memori tidak cukup untuk membuat array opsi atau driver inti tidak dapat melayani permintaan karena kurangnya memori.
E_UNEXPECTED atau kegagalan lain yang tidak tercantum di sini	Terjadi kondisi tak terduga. Driver inti mungkin dalam keadaan tidak valid. Pemanggil harus keluar dengan kode kegagalan.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	prcomoem.h (termasuk Prcomoem.h)

Lihat juga

IPrintCoreHelperPS

IPrintCoreHelperPS::EnumOptions

Share via