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