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 が指すバッファー領域の割り当てを解除します。

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

要件

要件	値
対象プラットフォーム	デスクトップ
Header	winsplp.h (Winsplp.h を含む)
Library	Spoolss.lib
[DLL]	Spoolss.dll

こちらもご覧ください

RefreshPrinterChangeNotification

RouterAllocPrinterNotifyInfo