次の方法で共有


RouterAllocPrinterNotifyInfo 関数 (winsplp.h)

印刷スプーラーの RouterAllocPrinterNotifyInfo 関数は、PRINTER_NOTIFY_INFO構造体とPRINTER_NOTIFY_INFO_DATA構造体の配列を割り当てます。 (これらの構造については、Microsoft Windows SDK のドキュメントで説明されています)。

構文

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

パラメーター

cPrinterNotifyInfoData

割り当てるPRINTER_NOTIFY_INFO_DATA構造体配列のサイズを指定する呼び出し元指定の番号。

戻り値

この関数は、割り当てられたPRINTER_NOTIFY_INFO構造体へのポインターを返します。

備考

印刷プロバイダーは RouterAllocPrinterNotifyInfo を呼び出して、PRINTER_NOTIFY_INFO構造体と、プロバイダーの RefreshPrinterChangeNotification 関数が提供する必要があるPRINTER_NOTIFY_INFO_DATA構造体配列を割り当てる必要があります。

RouterAllocPrinterNotifyInfo 関数は、PRINTER_NOTIFY_INFO構造体の Version メンバーをスプーラーの通知実装の現在のバージョンに初期化します。 cPrinterNotifyInfoData に指定された数に関係なく、構造体の FlagsCount メンバー初期化します。

印刷プロバイダーは、appendPrinterNotifyInfoData を呼び出して、PRINTER_NOTIFY_INFO_DATA構造体配列のメンバーを入力する必要があります。

RefreshPrinterChangeNotification 正常に実行され、割り当てられた構造体が呼び出し元に返された場合は、呼び出し元が構造体メモリの割り当てを解除することを想定する必要があります。 ただし、RefreshPrinterChangeNotification エラーが発生した場合は、RouterFreePrinterNotifyInfo 呼び出してメモリの割り当てを解除する必要があります。

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

必要条件

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

関連項目

AppendPrinterNotifyInfoData

RefreshPrinterChangeNotification

RouterFreePrinterNotifyInfo