Funzione FindNextPrinterChangeNotification
La funzione FindNextPrinterChangeNotification recupera informazioni sulla notifica di modifica più recente per un oggetto di notifica delle modifiche associato a una stampante o a un server di stampa. Chiamare questa funzione quando viene soddisfatta un'operazione di attesa nell'oggetto di notifica delle modifiche.
La funzione reimposta anche l'oggetto di notifica delle modifiche allo stato non segnalato. È quindi possibile usare l'oggetto in un'altra operazione di attesa per continuare a monitorare la stampante o il server di stampa. Il sistema operativo imposta l'oggetto sullo stato segnalato alla successiva volta che si verifica una delle modifiche specificate nella stampante o nel server di stampa. La funzione FindFirstPrinterChangeNotification crea l'oggetto di notifica delle modifiche e specifica il set di modifiche da monitorare.
Sintassi
BOOL FindNextPrinterChangeNotification(
_In_ HANDLE hChange,
_Out_opt_ PDWORD pdwChange,
_In_opt_ LPVOID pPrinterNotifyOptions,
_Out_opt_ LPVOID *ppPrinterNotifyInfo
);
Parametri
-
hChange [in]
-
Handle per un oggetto di notifica di modifica associato a una stampante o a un server di stampa. Si ottiene un handle di questo tipo chiamando la funzione FindFirstPrinterChangeNotification . Il sistema operativo imposta l'oggetto notifica di modifica allo stato segnalato quando rileva una delle modifiche specificate nel filtro di notifica delle modifiche dell'oggetto.
-
pdwChange [out, facoltativo]
-
Puntatore a una variabile i cui bit sono impostati per indicare le modifiche che si sono verificate per causare la notifica più recente. I flag di bit che potrebbero essere impostati corrispondono a quelli specificati nel parametro fdwFilter della chiamata FindFirstPrinterChangeNotification . Il sistema imposta uno o più flag di bit seguenti.
Valore Significato - PRINTER_CHANGE_ADD_FORM
Un modulo è stato aggiunto al server. - PRINTER_CHANGE_ADD_JOB
Un processo di stampa è stato inviato alla stampante. - PRINTER_CHANGE_ADD_PORT
Una porta o un monitoraggio è stato aggiunto al server. - PRINTER_CHANGE_ADD_PRINT_PROCESSOR
Un processore di stampa è stato aggiunto al server. - PRINTER_CHANGE_ADD_PRINTER
Una stampante è stata aggiunta al server. - PRINTER_CHANGE_ADD_PRINTER_DRIVER
Un driver della stampante è stato aggiunto al server. - PRINTER_CHANGE_CONFIGURE_PORT
Una porta è stata configurata nel server. - PRINTER_CHANGE_DELETE_FORM
Un modulo è stato eliminato dal server. - PRINTER_CHANGE_DELETE_JOB
È stato eliminato un processo. - PRINTER_CHANGE_DELETE_PORT
Una porta o un monitoraggio è stato eliminato dal server. - PRINTER_CHANGE_DELETE_PRINT_PROCESSOR
Un processore di stampa è stato eliminato dal server. - PRINTER_CHANGE_DELETE_PRINTER
Una stampante è stata eliminata. - PRINTER_CHANGE_DELETE_PRINTER_DRIVER
Un driver della stampante è stato eliminato dal server. - PRINTER_CHANGE_FAILED_CONNECTION_PRINTER
Non è riuscita una connessione della stampante. - PRINTER_CHANGE_SET_FORM
Nel server è stato impostato un modulo. - PRINTER_CHANGE_SET_JOB
È stato impostato un processo. - PRINTER_CHANGE_SET_PRINTER
È stata impostata una stampante. - PRINTER_CHANGE_SET_PRINTER_DRIVER
È stato impostato un driver della stampante. - PRINTER_CHANGE_WRITE_JOB
I dati del processo sono stati scritti. - PRINTER_CHANGE_TIMEOUT
Timeout del processo. - PRINTER_CHANGE_SERVER
Windows 7: si è verificata una modifica nel server. -
pPrinterNotifyOptions [in, facoltativo]
-
Puntatore a una struttura PRINTER_NOTIFY_OPTIONS . Impostare il membro Flag di questa struttura su PRINTER_NOTIFY_OPTIONS_REFRESH, per consentire alla funzione di restituire i dati correnti per tutti i campi delle informazioni della stampante monitorati. La funzione ignora tutti gli altri membri della struttura. Questo parametro può essere NULL.
-
ppPrinterNotifyInfo [out, facoltativo]
-
Puntatore a una variabile puntatore che riceve un puntatore a un buffer allocato dal sistema, di sola lettura. Chiamare la funzione FreePrinterNotifyInfo per liberare il buffer al termine dell'operazione. Questo parametro può essere NULL se non sono necessarie informazioni.
Il buffer contiene una struttura PRINTER_NOTIFY_INFO che contiene una matrice di strutture PRINTER_NOTIFY_INFO_DATA . Ogni elemento della matrice contiene informazioni su uno dei campi specificati nel parametro pPrinterNotifyOptions della chiamata FindFirstPrinterChangeNotification. In genere, la funzione fornisce dati solo per i campi modificati per causare la notifica più recente. Tuttavia, se la struttura puntata dal parametro pPrinterNotifyOptions specifica PRINTER_NOTIFY_OPTIONS_REFRESH, la funzione fornisce dati per tutti i campi monitorati.
Se il bit di PRINTER_NOTIFY_INFO_DISCARDED è impostato nel membro Flag della struttura PRINTER_NOTIFY_INFO , si è verificato un overflow o un errore e le notifiche potrebbero essere state perse. In questo caso, non verranno inviate notifiche aggiuntive finché non si effettua una seconda chiamata FindNextPrinterChangeNotification che specifica PRINTER_NOTIFY_OPTIONS_REFRESH.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Nota
Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.
Chiamare la funzione FindNextPrinterChangeNotification dopo un'operazione di attesa su un oggetto di notifica creato da FindFirstPrinterChangeNotification è stato soddisfatto. La chiamata a FindNextPrinterChangeNotification consente di ottenere informazioni sulla modifica che ha soddisfatto l'operazione di attesa e reimposta l'oggetto di notifica in modo che possa essere segnalato quando si verifica la modifica successiva.
Con un'eccezione, non chiamare la funzione FindNextPrinterChangeNotification se l'oggetto di notifica di modifica non è nello stato segnalato. Se una funzione di attesa restituisce il valore WAIT_TIMEOUT, l'oggetto change non si trova nello stato segnalato. Chiamare la funzione FindNextPrinterChangeNotification solo se la funzione di attesa riesce senza timeout. L'eccezione è quando FindNextPrinterChangeNotification viene chiamato con il bit PRINTER_NOTIFY_OPTIONS_REFRESH impostato nel parametro pPrinterNotifyOptions . Si noti che anche quando questo flag è impostato, è comunque possibile impostare il flag PRINTER_NOTIFY_INFO_DISCARDED nel parametro ppPrinterNotifyInfo .
Per continuare a monitorare la stampante o il server di stampa per le modifiche, ripetere il ciclo di chiamata a una delle funzioni di attesa e quindi chiamare la funzione FindNextPrinterChangeNotification per esaminare la modifica e reimpostare l'oggetto di notifica.
FindNextPrinterChangeNotification può combinare più modifiche allo stesso campo delle informazioni sulla stampante in una singola notifica. Quando si verifica questo problema, la funzione comprime in genere tutte le modifiche per il campo in una singola voce nella matrice di strutture PRINTER_NOTIFY_INFO_DATA in ppPrinterNotifyInfo; la voce singola segnala solo le informazioni più aggiornate. Tuttavia, per alcuni campi di informazioni sul processo e sulla stampante, la funzione può restituire più voci di matrice per lo stesso campo. In questo caso, l'ultima voce di matrice per il campo segnala i dati correnti e le voci precedenti contengono i dati per le fasi intermedie.
Quando non è più necessario l'oggetto di notifica di modifica, chiuderlo chiamando la funzione FindClosePrinterChangeNotification .
Nota
In Windows XP con Service Pack 2 (SP2) e versioni successive, Internet Connection Firewall (ICF) blocca le porte della stampante per impostazione predefinita, ma è possibile abilitare un'eccezione per La condivisione file e stampa. Se un utente effettua una connessione stampante a un altro computer e l'eccezione non è abilitata, l'utente non riceverà notifiche di modifica della stampante dal server. Un amministratore del computer dovrà abilitare l'eccezione.
Esempio
Nell'esempio di codice seguente viene illustrato come monitorare lo stato della stampante usando queste funzioni.
// Get change notification handle for the printer
chgObject = FindFirstPrinterChangeNotification(
hPrinter,
PRINTER_CHANGE_JOB,
0,
NULL);
if (chgObject != INVALID_HANDLE_VALUE) {
while (bKeepMonitoring) {
// Wait for the change notification
WaitForSingleObject(chgObject, INFINITE);
fcnreturn = FindNextPrinterChangeNotification(
chgObject,
pdwChange,
NULL,
NULL);
if (fcnreturn) {
// Check value of *pdwChange and
// deal with the indicated change
}
// Insert some mechanism to stop monitoring
// such as:
//
// if (something happens) {
// bKeepMonitoring = false;
// }
//
}
// Close Printer Change Notification handle when finished.
FindClosePrinterChangeNotification(chgObject);
} else {
// Unable to open printer change notification handle
dwStatus = GetLastError();
}
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|