次の方法で共有

IPrintCoreHelperPS::GetGlobalAttribute メソッド (prcomoem.h)

  • [アーティクル]

IPrintCoreHelperPS::GetGlobalAttribute メソッドは、グローバル属性リストまたは特定のグローバル属性の値を取得します。

構文

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

パラメーター

[in] pszAttribute

要求された属性を指定する ANSI 文字列を含む呼び出し元が指定したバッファーへのポインター。 このパラメーターが NULL 場合、呼び出し元は、特定のグローバル属性名を指定する代わりに、サポートされているすべてのグローバル属性名のリストを要求します。

[out] pdwDataType

要求された属性のデータ型を指定する値を受け取る変数へのポインター。 この値は、printoem.h で定義されている EATTRIBUTE_DATATYPE 列挙型の列挙子です。

[out] ppbData

要求されたデータを含む呼び出し先割り当てバッファーへのポインター。 このメソッドが完了すると、呼び出し元はこのバッファーを解放する必要はありません。

[out] pcbSize

pbData パラメーターが指すバッファーのサイズをバイト単位で指定する変数へのポインター。

戻り値

IPrintCoreHelperPS::GetGlobalAttribute は、次のいずれかの値を返す必要があります。

リターン コード 形容
S_OK メソッドは成功しました。
E_FAIL メソッドが失敗しました。
E_INVALIDARG このメソッドは、存在しない属性のクエリを実行しようとしました。
E_OUTOFMEMORY pcbSize の値が、pbData によって指される出力バッファーに書き込まれるバイト数よりも小。

備考

IPrintCoreHelperPS::GetGlobalAttribute が、pszAttribute と pbData パラメーターを NULLに設定して呼び出された場合、このメソッドは、サポートされているすべてのグローバル属性名のリストに必要なバイト数 pcbSize を設定して返します。 このメソッドを 2 回目に呼び出した場合、pszAttributeNULL に設定され、前の呼び出しで pcbSize で指定されたサイズのバッファー pbData 設定されます。 このメソッドは、pdwDataType kADT_ASCII (EATTRIBUTE_DATATYPE 列挙型の列挙子) に設定され、サポートされているすべてのグローバルの NULL 区切りリストを指す pbData を して返します。属性名。 このリストは、2 つの null 文字で終了します。

IPrintCoreHelperPS::GetGlobalAttributeの詳細については、「GetGlobalAttribute の使用」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー prcomoem.h (Prcomoem.h を含む)

関連項目

IPrintCoreHelperPS の

IPrintCoreHelperPS::GetFeatureAttribute

IPrintCoreHelperPS::GetOptionAttribute