次の方法で共有

GdiGetSpoolFileHandle 関数 (winppi.h)

  • [アーティクル]

GdiGetSpoolFileHandle 関数は、印刷ジョブの EMF ファイルへのハンドルを返します。

構文

HANDLE GdiGetSpoolFileHandle(
  LPWSTR     pwszPrinterName,
  LPDEVMODEW pDevmode,
  LPWSTR     pwszDocName
);

パラメーター

pwszPrinterName

ターゲット プリンターの名前を表す文字列への呼び出し元指定ポインター。 次の「解説」セクションを参照してください。

pDevmode

呼び出し元が指定した DEVMODEW 構造体へのポインター。 次の「解説」セクションを参照してください。

pwszDocName

印刷ジョブのドキュメント名への呼び出し元指定ポインター。 次の「解説」セクションを参照してください。

戻り値

操作が成功した場合、この関数はスプール ファイル ハンドルを返します。 それ以外の場合、関数は NULL を返します。

注釈

GdiGetSpoolFileHandle 関数は、印刷プロセッサの PrintDocumentOnPrintProcessor 関数内で使用するために、gdi32.dll によってエクスポートされます。

印刷プロセッサが GdiGetSpoolFileHandle を呼び出すときは、次の表に示すように引数を指定する必要があります。

パラメーター 引数
pwszPrinterName 印刷プロセッサの OpenPrintProcessor 関数で受け取ったプリンター名へのポインター。
pDevmode 印刷プロセッサの OpenPrintProcessor 関数によって受け取られた PRINTPROCESSOROPENDATA 構造体に含まれる DEVMODEW 構造体へのポインター。
pwszDocName 印刷プロセッサの PrintDocumentOnPrintProcessor 関数によって受け取られたドキュメント名ポインター。

印刷プロセッサは、他の GDI 印刷関数を呼び出す前に GdiGetSpoolFileHandle 関数を呼び出す必要があります。これは、返されるハンドルを他の関数に渡す必要があるためです。 関数は OpenPrinter を呼び出してプリンターへの接続を開き、CreateDC を呼び出して描画用のデバイス コンテキストを作成します。 印刷プロセッサは、 GdiGetDC を呼び出すことによって、デバイス コンテキストのハンドルを取得できます。

詳細については、「 印刷プロセッサでの GDI 関数の使用」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
Header winppi.h (Winppi.h を含む)
Library Gdi32.Lib
[DLL] Gdi32.dll

こちらもご覧ください

GdiDeleteSpoolFileHandle