FindFirstPrinterChangeNotification 関数 (winspool.h)

  • [アーティクル]

警告

Windows 10以降、サードパーティの印刷プロバイダーをサポートする API は非推奨となりました。 Microsoft では、サード パーティの印刷プロバイダーへの投資はお勧めしません。 さらに、v4 印刷ドライバー モデルを使用できるWindows 8以降の製品では、サード パーティの印刷プロバイダーが v4 印刷ドライバーを使用するキューを作成または管理できない場合があります。

印刷プロバイダーの FindFirstPrinterChangeNotification 関数は、指定された一連のイベントが指定された印刷キューで発生したときにアプリケーションが通知を要求したことをプロバイダーに通知します。

構文

HANDLE FindFirstPrinterChangeNotification(
  HANDLE hPrinter,
  DWORD  fdwFilter,
  DWORD  fdwOptions,
  PVOID  pPrinterNotifyOptions
);

パラメーター

hPrinter

呼び出し元が指定したプリンター ハンドル。イベント通知が要求されているプリンターを識別します。 このハンドルは、 OpenPrinter から以前に取得されている必要があります。

fdwFilter

DWORD パラメーター fdwFilter を定義します。

fdwOptions

使用されていません。

pPrinterNotifyOptions

呼び出し元が指定したPRINTER_NOTIFY_OPTIONS構造体へのポインター (Windows SDKドキュメントで説明)。

戻り値

印刷ドライバー ハンドルを返します。

注釈

スプーラーが印刷プロバイダーの FindFirstPrinterChangeNotification 関数を呼び出すと、 pPrinterNotifyOptions は、指定されたイベントのいずれかが発生したときに印刷プロバイダーがスプーラーに送信する必要がある情報の種類を識別します。

アプリケーションが要求できる通知の種類の一覧と、イベントの説明に使用できる情報の種類の一覧については、Windows SDKドキュメントの FindFirstPrinterChangeNotification に関する説明を参照してください。 アプリケーションが通知を要求する可能性があるイベントの種類には、印刷ジョブまたはフォームの追加または削除が含まれます。 アプリケーションが要求する可能性がある情報の種類には、ジョブまたはフォーム パラメーターが含まれます。

印刷プロバイダーがポーリングを要求しない場合、印刷プロバイダーは PartialReplyPrinterChangeNotification または ReplyPrinterChangeNotification を呼び出すことによって、pPrinterNotifyOptions によって識別される情報の種類を指定する必要があります。

プロバイダーがポーリングを要求する場合 (つまり、PRINTER_NOTIFY_STATUS_POLLを設定します)、 ReplyPrinterChangeNotification を呼び出さないでください。 代わりに、スプーラーはアプリケーションに一定の間隔で通知します。

ポーリングされた印刷プロバイダーと非ポーリング印刷プロバイダーは、 RefreshPrinterChangeNotification 関数が呼び出されるたびに、要求されたすべての情報の種類の現在の状態を返す必要があります。

詳細については、「 プリンター変更通知のサポート」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header winspool.h (Winspool.h を含む)
Library WinSpool.lib
[DLL] WinSpool.drv

こちらもご覧ください

ReplyPrinterChangeNotification

PartialReplyPrinterChangeNotification

RefreshPrinterChangeNotification