RouterFreePrinterNotifyInfo 関数 (winsplp.h)

印刷スプーラーの RouterFreePrinterNotifyInfo 関数は、指定したPRINTER_NOTIFY_INFO構造体とそれに関連付けられているPRINTER_NOTIFY_INFO_DATA構造体配列の割り当てを解除します。 (これらの構造については、Microsoft Windows SDK のドキュメントで説明されています)。

構文

BOOL RouterFreePrinterNotifyInfo(
  [in, optional] PPRINTER_NOTIFY_INFO pInfo
);

パラメーター

[in, optional] pInfo

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

戻り値

操作が成功した場合、関数は TRUE 返します。 それ以外の場合、関数は FALSE 返します。

備考

印刷プロバイダーの RefreshPrinterChangeNotification 関数は、RouterFreePrinterNotifyInfo を呼び出して、RouterAllocPrinterNotifyInfoによって以前に割り当てられた構造体の割り当てを解除する必要がありますが、refreshPrinterChangeNotification エラーが発生した場合に限ります。 RefreshPrinterChangeNotification 成功した場合は、クライアント アプリケーションが構造体の割り当てを解除することを想定する必要があります。

指定されたPRINTER_NOTIFY_INFO構造体とそれに関連付けられたPRINTER_NOTIFY_INFO_DATA構造体配列の割り当てを解除するだけでなく、この関数は、PRINTER_NOTIFY_INFO_DATA構造体配列の任意の要素で pBuf 指すバッファー領域の割り当てを解除します。

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

必要条件

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

関連項目

RefreshPrinterChangeNotification

RouterAllocPrinterNotifyInfo の