MergeAndValidatePrintTicketThunk2 関数

[この関数はサポートされておらず、今後のバージョンの Windows では無効または削除される可能性があります。 PTMergeAndValidatePrintTicket には同等の機能が用意されており、代わりに使用する必要があります。]

2 つの印刷チケットをマージし、有効な有効な印刷チケットを返します。

構文

HRESULT MergeAndValidatePrintTicketThunk2(
  _In_      HPTPROVIDER hProvider,
  _In_      BYTE        *pBasePrintTicket,
  _In_      INT         basePrintTicketLength,
  _In_opt_  BYTE        *pDeltaPrintTicket,
  _In_      INT         deltaPrintTicketLength,
  _In_      DWORD       scope,
  _Out_     BYTE        **ppValidatedPrintTicket,
  _Out_     INT         *pValidatedPrintTicketLength,
  _Out_opt_ BSTR        *pbstrErrorMessage
);

パラメーター

hProvider [in]

開いている印刷チケット プロバイダーへのハンドル。 このハンドルは BindPTProviderThunk 関数によって返されます。

pBasePrintTicket [in]

「印刷スキーマ」で説明されているように XML で表される、基本 の印刷チケット データを含むバッファー。

basePrintTicketLength [in]

pBasePrintTicket によって参照されるバッファーのサイズ (バイト単位)。

pDeltaPrintTicket [in, optional]

マージする印刷チケットを含むバッファー。 印刷チケット データは、「 印刷スキーマ」で説明されているように XML で表されます。 このパラメーターの値は NULL にすることができます。

deltaPrintTicketLength [in]

pDeltaPrintTicket によって参照されるバッファーのサイズ (バイト単位)。

scope [in]

pDeltaPrintTicket と ppValidatedPrintTicket のスコープが、印刷ジョブ内の単一ページ、文書全体、またはすべてのドキュメントであるかどうかを示す値です。 このパラメーターの値は、DWORD としてキャストされる EPrintTicketScope 列挙のメンバーである必要があります。

ppValidatedPrintTicket [out]

マージおよび検証された印刷チケットを含むバッファーのアドレス。 この関数は、このバッファーを割り当てるために CoTaskMemAlloc を呼び出します。 バッファーが不要になった場合、呼び出し元は CoTaskMemFree を呼び出してバッファーを解放する必要があります。

pValidatedPrintTicketLength [out]

ppValidatedPrintTicket によって参照されるバッファーのサイズ (バイト単位)。

pbstrErrorMessage [out, optional]

pBasePrintTicket または pDeltaPrintTicket の印刷チケットに関して何が無効であるかを指定する文字列へのポインター。 両方とも有効な場合、この値は NULL です。 関数が戻るときに pbstrErrorMessage が NULL でない場合、呼び出し元は SysFreeString で文字列を解放する必要があります。

戻り値

メソッドが成功すると、 S_OKが返されます。それ以外の場合は、 HRESULT エラー コードが返されます。 COM エラー コードの詳細については、「 エラー処理」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
[DLL]	Prntvpt.dll

こちらもご覧ください

印刷スキーマ

PTMergeAndValidatePrintTicket

印刷

印刷スプーラー API 関数