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 フラグを設定します。

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

要件

こちらもご覧ください

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification