IPrintCoreHelperPS：：GetFeatureAttribute 方法 (prcomoem.h)

發行項
02/26/2024

IPrintCoreHelperPS：：GetFeatureAttribute 方法會擷取功能屬性清單或特定特徵屬性的值。

語法

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

參數

[in] pszFeatureKeyword

呼叫端提供的緩衝區指標，其中包含指定要查詢之 feature 關鍵詞的 ANSI 字串。此值可以從先前呼叫 IPrintCoreHelperPS：：EnumFeatures 取得。

[in] pszAttribute

呼叫端提供的緩衝區指標，其中包含指定所要求屬性的 ANSI 字串。如果此參數為 NULL，呼叫端會要求所有支援的功能屬性名稱清單，而不是指定特定的功能屬性名稱。

[out] pdwDataType

變數的指標，可接收指定所要求屬性之數據類型的值。這個值是 EATTRIBUTE_DATATYPE列舉類型的列舉值，定義於printoem.h中。

[out] ppbData

包含所要求數據的被呼叫端配置緩衝區指標。完成這個方法時，呼叫端不需要釋放這個緩衝區。

[out] pcbSize

變數的指標，可接收 pbData 參數所指向之緩衝區的大小，以位元組為單位。

傳回值

IPrintCoreHelperPS：：GetFeatureAttribute 應該傳回下列其中一個值。

傳回碼	描述
S_OK	此方法已成功。
E_FAIL	方法失敗。
E_INVALIDARG	方法嘗試查詢不存在的屬性。此值也可能表示無法辨識 feature 關鍵詞。
E_OUTOFMEMORY	在 sqlSize 中的值小於要寫入 pbData 所指向輸出緩衝區的位元組數目。此值也可能表示方法已使用 pbData 設定為 NULL 呼叫。

備註

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