Metode IPrintCoreHelperUni::EnumConstrainedOptions (prcomoem.h)

Artikel
03/08/2023

Metode IPrintCoreHelperUni::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, IPrintCoreHelperUni::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 IPrintOemUni::D evMode, parameter ini diperlukan. Dalam sebagian besar situasi lain, parameter harus NULL. Ketika driver inti mengatur pDevmode ke NULL, driver ini 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 dilayanakan 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 IPrintCoreHelperUni::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

IPrintCoreHelperUni::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 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

IPrintCoreHelperUni

IPrintCoreHelperUni::EnumOptions

Bagikan melalui