Metode IPrintCoreHelperPS::GetFeatureAttribute (prcomoem.h)

Metode IPrintCoreHelperPS::GetFeatureAttribute mengambil daftar atribut fitur atau nilai atribut fitur tertentu.

Sintaks

HRESULT GetFeatureAttribute(
  [in]  PCSTR  pszFeatureKeyword,
  [in]  PCSTR  pszAttribute,
  [out] PDWORD pdwDataType,
  [out] PBYTE  *ppbData,
  [out] PDWORD pcbSize
);

Parameter

[in] pszFeatureKeyword

Penunjuk ke buffer yang disediakan penelepon yang berisi string ANSI yang menentukan kata kunci fitur yang akan dikueri. Nilai ini dapat diperoleh dari panggilan sebelumnya ke IPrintCoreHelperPS::EnumFeatures.

[in] pszAttribute

Penunjuk ke buffer yang disediakan penelepon yang berisi string ANSI yang menentukan atribut yang diminta. Jika parameter ini NULL, pemanggil meminta daftar semua nama atribut fitur yang didukung alih-alih menentukan nama atribut fitur tertentu.

[out] pdwDataType

Penunjuk ke variabel yang menerima nilai yang menentukan jenis data atribut yang diminta. Nilai ini adalah enumerator dari jenis enumerasi EATTRIBUTE_DATATYPE , yang didefinisikan dalam printoem.h.

[out] ppbData

Penunjuk ke buffer yang dialokasikan callee yang berisi data yang diminta. Setelah menyelesaikan metode ini, pemanggil tidak perlu merilis buffer ini.

[out] pcbSize

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari buffer yang diacu oleh parameter pbData .

Nilai kembali

IPrintCoreHelperPS::GetFeatureAttribute harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Metode gagal.
E_INVALIDARG	Metode ini mencoba mengkueri atribut yang tidak ada. Nilai ini mungkin juga berarti bahwa kata kunci fitur tidak dikenali.
E_OUTOFMEMORY	Nilai dalam pcbSize lebih kecil dari jumlah byte yang akan ditulis ke buffer output yang diacu oleh pbData. Nilai ini mungkin juga berarti bahwa metode dipanggil dengan pbData diatur ke NULL.

Keterangan

Jika IPrintCoreHelperPS::GetFeatureAttribute dipanggil dengan parameter pszAttribute dan pbData yang diatur ke NULL, metode mengembalikan dengan pcbSize yang diatur ke jumlah byte yang diperlukan untuk daftar semua nama atribut yang didukung untuk fitur tersebut. Jika metode ini disebut untuk kedua kalinya, dengan pszAttribute diatur ke NULL dan pbData menunjuk ke buffer ukuran yang ditentukan dalam pcbSize di panggilan sebelumnya, metode mengembalikan dengan pdwDataType diatur ke kADT_ASCII (enumerator dari jenis enumerasi EATTRIBUTE_DATATYPE ) dan pbData menunjuk ke daftar yang dibatasi NULL dari semua nama atribut yang didukung untuk fitur tersebut. Daftar ini dihentikan dengan dua karakter null.

Untuk informasi selengkapnya tentang IPrintCoreHelperPS::GetFeatureAttribute, lihat Menggunakan GetFeatureAttribute.

Persyaratan

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

Lihat juga

IPrintCoreHelperPS

IPrintCoreHelperPS::GetGlobalAttribute

IPrintCoreHelperPS::GetOptionAttribute