印刷スプーラー API 関数

印刷スプーラー API には、アプリケーションが Windows 印刷スプーラーと、それを制御するプリンターと印刷ジョブを管理するために使用する関数とデータ構造が含まれています。

印刷スプーラー API の関数は、次のグループに分かれています。

• 印刷ジョブ機能の
• プリンター ユーザー インターフェイス関数の
• プリンター機能の
• プリンター変更通知機能
• プリンター フォーム関数の
• 印刷スプーラー機能

印刷ジョブ関数

これらの関数は、印刷ジョブをプリンターに送信し、印刷スプーラーの印刷ジョブを追跡および制御します。

機能	形容
AddJobをする	AddJob 関数は、印刷スプーラーによってスケジュールできる印刷ジョブの一覧に印刷ジョブを追加します。 この関数は、ジョブの格納に使用できるファイルの名前を取得します。
ClosePrinterの	ClosePrinter 関数は、指定したプリンター オブジェクトを閉じます。
DocumentEventの	DocumentEvent 関数は、ドキュメントの印刷に関連付けられているイベントのイベント ハンドラーです。
DocumentProperties	DocumentProperties 関数は、プリンターの初期化情報を取得または変更するか、指定したプリンターのプリンター構成プロパティ シートを表示します。
EndDocPrinterの	EndDocPrinter 関数は、指定したプリンターの印刷ジョブを終了します。
EndPagePrinterの	EndPagePrinter 関数は、アプリケーションが印刷ジョブのページの末尾にあることを印刷スプーラーに通知します。
EnumJobsの	EnumJobs 関数は、指定したプリンターの指定した印刷ジョブのセットに関する情報を取得します。
GetJobをする	GetJob 関数は、指定された印刷ジョブに関する情報を取得します。
OpenPrinter	OpenPrinter 関数は、指定されたプリンター、プリント サーバー、または印刷サブシステム内の他の種類のハンドルへのハンドルを取得します。
OpenPrinter2	プリンター オプションの一部を設定しながら、指定したプリンター、プリント サーバー、または印刷サブシステム内の他の種類のハンドルへのハンドルを取得します。
ReportJobProcessingProgressの	XPS 印刷ジョブがスプール段階かレンダリング フェーズか、および現在処理中の処理の部分を印刷スプーラー サービスに報告します。
ScheduleJob	ScheduleJob 関数は、印刷スプーラーが印刷のために指定された印刷ジョブをスケジュールすることを要求します。
SetJobの	SetJob 関数は、指定されたプリンターで印刷ジョブを一時停止、再開、取り消し、または再開します。 SetJob 関数を使用して、印刷ジョブの優先順位やドキュメント名などの印刷ジョブ パラメーターを設定することもできます。
StartDocPrinterの	StartDocPrinter 関数は、文書を印刷用にスプールすることを印刷スプーラーに通知します。
StartPagePrinterをする	StartPagePrinter 関数は、指定したプリンターでページが印刷されようとしていることをスプーラーに通知します。

プリンター ユーザー インターフェイス関数

これらの関数は、ユーザーがプリンターを選択または構成できるようにするユーザー インターフェイスを表示します。

機能	形容
AdvancedDocumentProperties	AdvancedDocumentProperties 関数は、指定したプリンターのプリンター構成ダイアログ ボックスを表示し、ユーザーがそのプリンターを構成できるようにします。
ConfigurePortの	ConfigurePort 関数は、指定されたサーバー上のポートのポート構成ダイアログ ボックスを表示します。
ConnectToPrinterDlgの	ConnectToPrinterDlg 関数は、ユーザーがネットワーク上のプリンターを参照して接続できるようにするダイアログ ボックスを表示します。 ユーザーがプリンターを選択すると、関数はプリンターへの接続を作成しようとします。適切なドライバーがサーバーにインストールされていない場合、ユーザーにはプリンターをローカルで作成するオプションが与えられます。
PrinterProperties	PrinterProperties 関数は、指定したプリンターのプリンター プロパティ シートを表示します。

プリンター関数

これらの機能は、印刷スプーラーが使用するプリンターを追加および構成します。

機能	形容
AbortPrinterの	AbortPrinter 関数は、プリンターがスプール用に構成されている場合、プリンターのスプール ファイルを削除します。
AddPrinterの	AddPrinter 関数は、指定されたサーバーでサポートされているプリンターの一覧にプリンターを追加します。
AddPrinterConnectionの	AddPrinterConnection 関数は、現在のユーザーの指定したプリンターに接続を追加します。
AddPrinterConnection2の	現在のユーザーの指定したプリンターに接続を追加し、接続の詳細を指定します。
DeletePrinterの	DeletePrinter 関数は、指定したプリンター オブジェクトを削除します。
DeletePrinterConnectionの	DeletePrinterConnection 関数は、AddPrinterConnection または ConnectToPrinterDlg呼び出しによって確立されたプリンターへの接続を削除します。
DeletePrinterDataの	DeletePrinterData 関数は、プリンターの指定された構成データを削除します。 プリンターの構成データは、名前付き値と型指定された値のセットで構成されます。 DeletePrinterData 関数は、値名で指定されたこれらの値のいずれかを削除します。
DeletePrinterDataExの	DeletePrinterDataEx 関数は、プリンターの構成データから指定した値を削除します。 プリンターの構成データは、レジストリ キーの階層に格納されている名前付き値と型指定された値のセットで構成されます。 この関数は、指定したキーの下にある指定した値を削除します。
DeletePrinterKeyの	DeletePrinterKey 関数は、指定したプリンターの指定したキーとそのすべてのサブキーを削除します。
EnumPrinterDataの	EnumPrinterData 関数は、指定したプリンターの構成データを列挙します。
EnumPrinterDataExの	EnumPrinterDataEx 関数は、指定したプリンターとキーのすべての値の名前とデータを列挙します。
EnumPrinterKeyの	EnumPrinterKey 関数は、指定したプリンターの指定したキーのサブキーを列挙します。
EnumPrintersの	EnumPrinters 関数は、使用可能なプリンター、プリント サーバー、ドメイン、または印刷プロバイダーを列挙します。
FlushPrinterの	FlushPrinter 関数は、一時的な状態からバッファーをクリアするために、プリンターにバッファーを送信します。
GetDefaultPrinterの	GetDefaultPrinter 関数は、ローカル コンピューター上の現在のユーザーの既定のプリンターのプリンター名を取得します。
GetPrinterの	GetPrinter 関数は、指定したプリンターに関する情報を取得します。
GetPrinterDataの	GetPrinterData 関数は、指定されたプリンターまたはプリント サーバーの構成データを取得します。
GetPrinterDataExの	GetPrinterDataEx 関数は、指定されたプリンターまたはプリント サーバーの構成データを取得します。 GetPrinterDataEx は、SetPrinterData 関数によって格納された値を取得できます。 さらに、GetPrinterDataEx では、SetPrinterDataEx 関数によって指定されたキーに格納されている値を取得できます。
IsValidDevmodeの	IsValidDevmode 関数は、DEVMODE 構造体の内容が有効であることを確認します。
ReadPrinterの	ReadPrinter 関数は、指定したプリンターからデータを取得します。
ResetPrinterの	ResetPrinter 関数は、StartDocPrinter 関数によって送信されたドキュメントの印刷に使用するデータ型とデバイス モードの値を指定します。 これらの値は、ドキュメント印刷の開始後に SetJob 関数を使用してオーバーライドできます。
SetDefaultPrinterの	SetDefaultPrinter 関数は、ローカル コンピューター上の現在のユーザーの既定のプリンターのプリンター名を設定します。
SetPortの	SetPort 関数は、プリンター ポートに関連付けられている状態を設定します。
SetPrinterの	SetPrinter 関数は、印刷の一時停止、印刷の再開、またはすべての印刷ジョブのクリアによって、指定したプリンターのデータを設定するか、指定したプリンターの状態を設定します。
SetPrinterDataの	SetPrinterData 関数は、プリンターまたはプリント サーバーの構成データを設定します。
SetPrinterDataExの	SetPrinterDataEx 関数は、プリンターまたはプリント サーバーの構成データを設定します。 この関数は、プリンターのレジストリ キーの下に構成データを格納します。
WritePrinterの	WritePrinter 関数は、指定したプリンターにデータを書き込む必要があることを印刷スプーラーに通知します。

プリンター変更通知機能

これらの機能を使用すると、アプリケーションにプリンターの状態の変更を通知できます。

機能	形容
FindClosePrinterChangeNotification	FindClosePrinterChangeNotification 関数は、FindFirstPrinterChangeNotification 関数を呼び出して作成された変更通知オブジェクトを閉じます。 変更通知オブジェクトに関連付けられているプリンターまたはプリント サーバーは、そのオブジェクトによって監視されなくなります。
FindFirstPrinterChangeNotificationの	FindFirstPrinterChangeNotification 関数は、変更通知オブジェクトを作成し、オブジェクトへのハンドルを返します。 その後、待機機能の 1 つを呼び出してこのハンドルを使用して、プリンターまたはプリント サーバーへの変更を監視できます。
FindNextPrinterChangeNotificationの	FindNextPrinterChangeNotification 関数は、プリンターまたはプリント サーバーに関連付けられている変更通知オブジェクトの最新の変更通知に関する情報を取得します。 変更通知オブジェクトに対する待機操作が満たされた場合に、この関数を呼び出します。
FreePrinterNotifyInfoをする	FreePrinterNotifyInfo 関数は、FindNextPrinterChangeNotification 関数によって作成されたシステム割り当てバッファーを解放します。

プリンター フォーム関数

これらの関数は、プリンターで使用されるフォームを管理します。

機能	形容
AddFormをする	AddForm 関数は、指定したプリンターで選択できるフォームの一覧にフォームを追加します。
DeleteFormの	DeleteForm 関数は、サポートされているフォームの一覧からフォーム名を削除します。
EnumFormsの	EnumForms 関数は、指定したプリンターでサポートされているフォームを列挙します。
GetFormの	GetForm 関数は、指定したフォームに関する情報を取得します。
SetFormの	SetForm 関数は、指定したプリンターのフォーム情報を設定します。

印刷スプーラー関数

これらの関数は、低レベルで印刷スプーラーと対話します。

機能	形容
CloseSpoolFileHandle	CloseSpoolFileHandle 関数は、アプリケーションによって現在送信されている印刷ジョブに関連付けられているスプール ファイルへのハンドルを閉じます。
CommitSpoolDataの	CommitSpoolData 関数は、指定された量のデータが指定されたスプール ファイルに書き込まれ、レンダリングの準備ができていることを印刷スプーラーに通知します。
GetPrintExecutionDataの	GetPrintExecutionData は、現在の印刷コンテキストを取得します。
GetSpoolFileHandleの	GetSpoolFileHandle 関数は、アプリケーションによって現在送信されているジョブに関連付けられているスプール ファイルのハンドルを取得します。