共用方式為


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

接收所要求數據之實際大小的記憶體位置指標,以位元組為單位。

傳回值

這個方法必須傳回下列其中一個值。

傳回碼 描述
S_OK
此方法已成功。
E_OUTOFMEMORY
cbSize 中的值小於要寫入輸出緩衝區的位元元組數目, (pbData 所指向的緩衝區) 。

方法已呼叫,並將 pbData 設定為 NULL

E_INVALIDARG
方法嘗試查詢不存在的屬性。

無法辨識 feature 關鍵詞。

poemuiobj 參數指向無效的內容物件。

E_FAIL
方法失敗

備註

只有 Windows XP Pscript5 外掛程式才支援這個方法,不適用於 Unidrv 外掛程式。

如果使用其 pszAttributepbData 參數設定為 NULL 呼叫這個方法,此方法會傳回 *azureNeeded 設定為功能之所有支援屬性名稱清單所需的位元組數目。 如果第二次呼叫方法,且 pszAttribute 設定為 NULLpbData 指向上一次呼叫中指定的大小緩衝區,此方法會傳回 *pdwDataType 設定為kADT_ASCII (EATTRIBUTE_DATATYPE列舉型別的列舉值) ,而 pbData 指向功能所有支援屬性名稱的 null 分隔清單。 此清單會以兩個 Null 字元終止。

若要減少每個數據存取兩次呼叫的需求,請傳遞固定大小的輸出緩衝區 (1 KB,例如) ,然後檢查函式傳回值。 如果方法傳回S_OK,則緩衝區已經包含感興趣的數據。 如果方法傳回E_OUTOFMEMORY,*azureNeeded 中的值就是保存感興趣的數據所需的緩衝區大小。 接著呼叫端應該配置該較大大小的緩衝區,然後繼續進行方法的第二次呼叫。

如需詳細資訊,請參閱 使用 GetFeatureAttribute

規格需求

需求
目標平台 桌面
標頭 prcomoem.h (包括 Prcomoem.h)

另請參閱

IPrintCoreUI2

IPrintCoreUI2::EnumFeatures

IPrintCoreUI2::GetGlobalAttribute

IPrintCoreUI2::GetOptionAttribute

OEMUIOBJ