GetSpoolFileHandle 関数

GetSpoolFileHandle 関数は、アプリケーションによって現在送信されているジョブに関連付けられているスプール ファイルのハンドルを取得します。

構文

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

パラメーター

hPrinter [in]

ジョブが送信されたプリンターへのハンドル。 これは、ジョブの送信に使用されたものと同じハンドルである必要があります。 (プリンター ハンドルを取得するには、 OpenPrinter 関数または AddPrinter 関数を使用します)。

戻り値

関数が成功すると、スプール ファイルにハンドルが返されます。

関数が失敗した場合は、 INVALID_HANDLE_VALUEを返します。

注釈

スプール・ファイルへのハンドルを使用すると、アプリケーションは WriteFile の呼び出しと CommitSpoolData の呼び出しを使用してスプール・ファイルに書き込むことができます。

アプリケーションは、最後にスプール ファイルにアクセスするまで、hPrinter で ClosePrinter を呼び出す必要があります。 その後、 CloseSpoolFileHandle を呼び出し、その後 に ClosePrinter を呼び出す必要があります。 元の hPrinter が閉じられた後にスプール ファイル ハンドルにアクセスしようとすると、ファイル ハンドル自体が閉じていない場合でも失敗します。 CloseSpoolFileHandle は、 ClosePrinter が最初に呼び出されると失敗します。

この関数は、印刷ジョブがスプールを完了する前に呼び出されると失敗します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	Winspool.h (Windows.h を含む)
ライブラリ	Winspool.lib
[DLL]	WinSpool.drv
Unicode 名と ANSI 名	GetSpoolFileHandleW (Unicode) と GetSpoolFileHandleA (ANSI)

関連項目

印刷

印刷スプーラー API 関数

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData