RouterAllocPrinterNotifyInfo 関数 (winsplp.h)

[アーティクル]
03/05/2024

印刷スプーラーの 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 して、プロバイダーの RefreshPrinterChangeNotification 関数が提供する必要があるPRINTER_NOTIFY_INFO構造体とPRINTER_NOTIFY_INFO_DATA構造体配列を割り当てる必要があります。

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

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

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

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