IPrintCorePS2：：GetFeatureAttribute 方法 （prcomoem.h）
IPrintCorePS2::GetFeatureAttribute 方法會擷取功能屬性清單或特定特徵屬性的值。
語法
HRESULT GetFeatureAttribute(
[in] PDEVOBJ pdevobj,
[in] DWORD dwFlags,
[in] PCSTR pszFeatureKeyword,
[in] PCSTR pszAttribute,
[out] PDWORD pdwDataType,
[out] PBYTE pbData,
[in] DWORD cbSize,
[out] PDWORD pcbNeeded
);
參數
[in] pdevobj
DEVOBJ 結構的指標。
[in] dwFlags
已保留 ，且必須設定為零。
[in] pszFeatureKeyword
呼叫端提供的緩衝區指標，其中包含指定要查詢之單一功能關鍵詞的 ASCII 字串。 此值可以從先前呼叫 IPrintCorePS2：：EnumFeatures取得。
[in] pszAttribute
呼叫端提供的緩衝區指標，其中包含指定所要求之單一屬性的 ASCII 字串。 如果此參數 NULL，則呼叫端會要求所有支援的功能屬性名稱清單，而不是指定特定的特徵屬性名稱。
[out] pdwDataType
接收指定所要求屬性數據類型之值的記憶體位置指標。 這個值是 EATTRIBUTE_DATATYPE 列舉的列舉值，定義於 printoem.h 中。
[out] pbData
接收要求數據的呼叫端提供的緩衝區指標。 若要只查詢滿足要求所需的位元元數目，請將此參數設定為 NULL。
[in] cbSize
指定 pbData所指向之緩衝區的大小，以位元組為單位。
[out] pcbNeeded
記憶體位置的指標，該位置會接收所要求數據的實際大小，以位元組為單位。
傳回值
這個方法必須傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
方法成功。 |
|
cbSize 中的值小於要寫入輸出緩衝區的位元組數目（pbData所指向的緩衝區）。
呼叫 方法時，pbData 設定為 NULL。 |
|
方法嘗試查詢不存在的屬性。
無法辨識功能關鍵詞。 pdevobj 參數指向無效的驅動程序內容物件。 |
|
方法失敗。 |
言論
如果呼叫這個方法時，其 pszAttribute，且 pbData 參數設定為 NULL，此方法會傳回 * 設為功能所有支援屬性名稱清單所需的位元組數目。 如果方法第二次呼叫，pszAttribute 設定為 NULL，pbData 指向上一個呼叫中指定的大小緩衝區*， 方法會傳回 *pdwDataType 設定為 kADT_ASCII （EATTRIBUTE_DATATYPE 列舉型別的列舉值），pbData 指向功能所有支援屬性名稱的 null 分隔清單。 此清單會以兩個 Null 字元終止。
若要減少每次數據存取兩次呼叫的需求，請傳遞固定大小的輸出緩衝區 （例如 1 KB），然後檢查函式傳回值。 如果方法傳回S_OK，則緩衝區已經包含感興趣的數據。 如果方法傳回E_OUTOFMEMORY，* 中的值就是保存感興趣數據的緩衝區大小。 接著，呼叫端應該配置大小較大的緩衝區，然後繼續進行方法的第二次呼叫。
任何 Pscript5 轉譯外掛程式都支援此方法。
如需詳細資訊，請參閱使用 GetFeatureAttribute 。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | prcomoem.h （include Prcomoem.h） |