PartialReplyPrinterChangeNotification 関数 (winsplp.h)

印刷スプーラーの PartialReplyPrinterChangeNotification 関数を使用すると、印刷プロバイダーは、通知ハンドルに関連付けられているプリンター変更のスプーラーのデータベースを更新できます。

構文

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

パラメーター

hPrinter

呼び出し元が指定したハンドル。 このハンドルは、印刷プロバイダーの FindFirstPrinterChangeNotification 関数への hNotify 入力として以前に受信されている必要があります。

pDataSrc

呼び出し元が指定したPRINTER_NOTIFY_INFO_DATA構造体へのポインター (Microsoft Windows SDK ドキュメントで説明)。 NULL できます。 詳細については、次の「解説」セクションを参照してください。

戻り値

操作が成功した場合、関数は TRUE 返します。 それ以外の場合、関数は FALSE 返します。 呼び出し元は、GetLastError 呼び出すことによってエラー コードを取得できます。

備考

指定した通知ハンドルのスプーラーの PartialReplyPrinterChangeNotification 関数は、指定したPRINTER_NOTIFY_INFO_DATA構造体の内容をスプーラーの格納されているPRINTER_NOTIFY_INFO構造体内の配列に追加します。 (これらの構造については、Windows SDK のドキュメントで説明されています)。

PartialReplyPrinterChangeNotification 呼び出しても、スプーラーは変更が発生したことをアプリケーションに通知しません。 印刷プロバイダーの FindFirstPrinterChangeNotification 関数がPRINTER_NOTIFY_STATUS_POLL フラグを設定しなかった場合、プロバイダーは ReplyPrinterChangeNotification 呼び出してアプリケーションに通知する必要があります。

pInfoDataSrc が NULL 場合、指定したハンドルに関連付けられているすべての格納情報がスプーラーから削除されます。 この削除は、指定されたハンドルに属するPRINTER_NOTIFY_INFO_DATA構造体のメンバー pBuf に関連付けられているすべてのバッファーを解放することによって、この削除を実行します。 次に、この関数は、格納されているPRINTER_NOTIFY_INFO構造体にPRINTER_NOTIFY_INFO_DISCARDED フラグを設定します。

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

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	winsplp.h (Winsplp.h を含む)
ライブラリ	Spoolss.lib
DLL	Spoolss.dll

関連項目

FindFirstPrinterChangeNotification の

ReplyPrinterChangeNotification の