ConvertPrintTicketToDevModeThunk2 関数
[この関数はサポートされておらず、今後のバージョンの Windows では無効または削除される可能性があります。 PTConvertPrintTicketToDevMode は同等の機能を提供し、代わりに使用する必要があります。
印刷チケットを DEVMODE 構造体に変換します。
構文
HRESULT ConvertPrintTicketToDevModeThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pPrintTicket,
_In_ ULONG cbSize,
_In_ INT baseType,
_In_ DWORD scope,
_Out_ BYTE **ppDevmode,
_Out_ ULONG *pcbDevModeLength,
_Out_opt_ BSTR *errMsg
);
パラメーター
-
hProvider [in]
-
開いている印刷チケット プロバイダーへのハンドル。 このハンドルは BindPTProviderThunk 関数によって返されます。
-
pPrintTicket [in]
-
変換する印刷チケットを含むバッファー。
-
cbSize [in]
-
pPrintTicket で渡されるバッファーのサイズ (バイト単位)。
-
baseType [in]
-
pPrintTicket で DEVMODE に使用可能なすべての設定が指定されていない場合に、ユーザーの既定の DEVMODE と印刷キューの既定の DEVMODE のどちらを使用して出力 DEVMODE に値を提供するかを示す値。 このパラメーターの値は、INT としてキャストされた EDefaultDevmodeType 列挙体のメンバーである必要があります。
-
scope [in]
-
pPrintTicket のスコープを指定する 値。 この値は、1 つのページ、文書全体、または印刷ジョブ内のすべてのドキュメントを指定できます。 このパラメーターの値は、DWORD としてキャストされた EPrintTicketScope 列挙体のメンバーである必要があります。
-
ppDevmode [out]
-
新しく作成された DEVMODE のアドレス。 この関数は、このバッファーを割り当てるために CoTaskMemAlloc を呼び出します。 バッファーが不要になった場合、呼び出し元は CoTaskMemFree を呼び出してバッファーを解放する必要があります。
-
pcbDevModeLength [out]
-
ppDevmode で返される DEVMODE のサイズ (バイト単位)。
-
errMsg [out, optional]
-
pPrintTicket の印刷チケットに関して何が無効であるかを指定する文字列へのポインター。 有効な場合、これは NULL です。 関数が戻るときに errMsg が NULL でない場合、呼び出し元は SysFreeString で文字列を解放する必要があります。
戻り値
メソッドが成功した場合は、 S_OKを返します。それ以外の場合は、 HRESULT エラー コードを返します。 COM エラー コードの詳細については、「エラー 処理」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| [DLL] |
|