次の方法で共有

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 関数の使用」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー winppi.h (Winppi.h を含む)
ライブラリ Gdi32.Lib
DLL Gdi32.dll

関連項目

GdiDeleteSpoolFileHandle を する