Funzione PartialReplyPrinterChangeNotification (winsplp.h)

  • Articolo

La funzione PartialReplyPrinterChangeNotification dello spooler di stampa consente a un provider di stampa di aggiornare il database dello spooler delle modifiche della stampante associate a un handle di notifica.

Sintassi

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

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.

pDataSrc

Puntatore fornito dal chiamante a una struttura PRINTER_NOTIFY_INFO_DATA (descritta nella documentazione di Microsoft Windows SDK). Può essere NULL. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

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

Per l'handle di notifica specificato, la funzione PartialReplyPrinterChangeNotification dello spooler aggiunge il contenuto della struttura di PRINTER_NOTIFY_INFO_DATA specificata alla matrice all'interno della struttura PRINTER_NOTIFY_INFO archiviata dello spooler. Queste strutture sono descritte nella documentazione di Windows SDK.

La chiamata a PartialReplyPrinterChangeNotification non causa la notifica dello spooler all'applicazione che sono state apportate modifiche. Se la funzione FindFirstPrinterChangeNotification del provider di stampa non ha impostato il flag PRINTER_NOTIFY_STATUS_POLL, il provider deve chiamare ReplyPrinterChangeNotification per fare in modo che l'applicazione venga notificata.

Se pInfoDataSrc è NULL, tutte le informazioni archiviate associate all'handle specificato vengono eliminate dallo spooler. La funzione esegue questa eliminazione liberando tutti i buffer associati ai membri pBuf di PRINTER_NOTIFY_INFO_DATA strutture appartenenti all'handle specificato. La funzione imposta quindi il flag PRINTER_NOTIFY_INFO_DISCARDED nella struttura PRINTER_NOTIFY_INFO archiviata.

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

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione winsplp.h (include Winsplp.h)
Libreria Spoolss.lib
DLL Spoolss.dll

Vedi anche

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification