Funzione ReplyPrinterChangeNotification (winsplp.h)

Articolo
04/03/2024

La funzione ReplyPrinterChangeNotification dello spooler di stampa consente a un provider di stampa di aggiornare il database dello spooler degli eventi della coda di stampa associati a un handle di notifica e di notificare al client che si sono verificati eventi della coda di stampa.

Sintassi

BOOL ReplyPrinterChangeNotification(
                  HANDLE hPrinter,
                  DWORD  fdwChangeFlags,
  [out, optional] PDWORD pdwResult,
  [in, optional]  PVOID  pPrinterNotifyInfo
);

Parametri

hPrinter

Handle fornito dal chiamante. Questo handle deve essere stato ricevuto in precedenza come input hNotify per la funzione FindFirstPrinterChangeNotification del provider di stampa.

fdwChangeFlags

Uno o più flag con prefisso PRINTER_CHANGE_ fornito dal chiamante, elencati nella descrizione della documentazione di Microsoft Windows SDK di FindNextPrinterChangeNotification.

[out, optional] pdwResult

facoltativo. Se non è NULL, riceve flag con prefisso PRINTER_NOTIFY_INFO fornito dallo spooler che indica i risultati dell'aggiornamento delle informazioni fornite.

[in, optional] pPrinterNotifyInfo

facoltativo. Indirizzo fornito dal chiamante di una struttura di PRINTER_NOTIFY_INFO (descritta nella documentazione di Windows SDK). Può essere NULL se non vengono aggiunte nuove informazioni di notifica.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce TRUE. In caso contrario, la funzione restituisce FALSE. Il chiamante può ottenere un codice di errore chiamando GetLastError.

Commenti

I provider di stampa che non supportano il polling (vedere FindFirstPrinterChangeNotification) devono notificare allo spooler l'occorrenza di eventi rappresentati dai flag con prefisso PRINTER_CHANGE_ ricevuti dalla funzione FindFirstPrinterChangeNotification del provider. Quando si verifica un evento, il provider di stampa può chiamare ReplyPrinterChangeNotification per informare lo spooler dell'evento e fornire informazioni associate all'evento. Lo spooler tiene traccia di queste informazioni sull'evento, per ogni handle di notifica e recapita le informazioni a un'applicazione quando l'applicazione chiama FindNextPrinterChangeNotification (descritta nella documentazione di Windows SDK).

Quando un provider di stampa chiama ReplyPrinterChangeNotification, deve identificare l'evento che si è verificato impostando un flag con prefisso PRINTER_CHANGE_ in fwdFlags o utilizzando pPrinterNotifyInfo per restituire una struttura PRINTER_NOTIFY_INFO. Usare i flag elencati nella descrizione della documentazione di Windows SDK di FindNextPrinterChangeNotification, non i flag elencati nella descrizione della documentazione di Windows SDK di FindFirstPrinterChangeNotification.

Chiamando ReplyPrinterChangeNotification , lo spooler segnala all'applicazione client che si è verificato un evento della coda di stampa. Ciò si verifica anche se il provider fornisce NULL per pPrinterNotifyInfo. Per aggiornare il record dello spooler delle modifiche della coda di stampa senza che il client venga informato, usare PartialReplyPrinterChangeNotification. È comune chiamare PartialReplyPrinterChangeNotification più volte per aggiornare il database dello spooler, quindi chiamare ReplyPrinterChangeNotification per notificare al client che sono state apportate modifiche.

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