Funzione RouterAllocPrinterNotifyInfo (winsplp.h)

Articolo
03/05/2024

La funzione di RouterAllocPrinterNotifyInfo spooler di stampa alloca una struttura PRINTER_NOTIFY_INFO e una matrice di strutture PRINTER_NOTIFY_INFO_DATA. Queste strutture sono descritte nella documentazione di Microsoft Windows SDK.

Sintassi

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

Parametri

cPrinterNotifyInfoData

Numero fornito dal chiamante che specifica le dimensioni della matrice di struttura PRINTER_NOTIFY_INFO_DATA da allocare.

Valore restituito

La funzione restituisce un puntatore alla struttura PRINTER_NOTIFY_INFO allocata.

Commenti

I provider di stampa devono chiamare RouterAllocPrinterNotifyInfo per allocare la struttura PRINTER_NOTIFY_INFO e la matrice di struttura PRINTER_NOTIFY_INFO_DATA che la funzione RefreshPrinterChangeNotification del provider deve fornire.

La RouterAllocPrinterNotifyInfo funzione inizializza il membro Version della struttura PRINTER_NOTIFY_INFO alla versione corrente dell'implementazione della notifica del spooler. Inizializza i flag e i membri count della struttura su zero, indipendentemente dal numero specificato per cPrinterNotifyInfoData.

I provider di stampa devono chiamare AppendPrinterNotifyInfoData per compilare i membri della matrice di strutture PRINTER_NOTIFY_INFO_DATA.

Se RefreshPrinterChangeNotification viene eseguito correttamente e restituisce le strutture allocate al chiamante, è consigliabile presupporre che il chiamante deallocate la memoria della struttura. Tuttavia, se RefreshPrinterChangeNotification si verifica un errore, deve chiamare RouterFreePrinterNotifyInfo per deallocare la memoria.

Per altre informazioni, vedere Supporto delle notifiche di modifica della stampante.