IPrintCoreUI2：：GetFeatureAttribute 方法 (prcomoem.h)

發行項
02/26/2024

方法 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 外掛程式。

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

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

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