IPrintCoreHelperPS：：GetGlobalAttribute 方法 (prcomoem.h)

發行項
02/29/2024

IPrintCoreHelperPS：：GetGlobalAttribute 方法會擷取全域屬性清單或特定全域屬性的值。

語法

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

參數

[in] pszAttribute

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

[out] pdwDataType

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

[out] ppbData

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

[out] pcbSize

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

傳回值

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

傳回碼	描述
S_OK	此方法已成功。
E_FAIL	方法失敗。
E_INVALIDARG	方法嘗試查詢不存在的屬性。
E_OUTOFMEMORY	在 sqlSize 中的值小於要寫入 pbData 所指向輸出緩衝區的位元組數目。

備註

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