Funzione FindFirstPrinterChangeNotification
La funzione FindFirstPrinterChangeNotification crea un oggetto di notifica di modifica e restituisce un handle all'oggetto. È quindi possibile usare questo handle in una chiamata a una delle funzioni di attesa per monitorare le modifiche apportate alla stampante o al server di stampa.
La chiamata FindFirstPrinterChangeNotification specifica il tipo di modifiche da monitorare. È possibile specificare un set di condizioni da monitorare per le modifiche, un set di campi delle informazioni della stampante da monitorare o entrambi.
Un'operazione di attesa nell'handle di notifica delle modifiche ha esito positivo quando si verifica una delle modifiche specificate nella stampante o nel server di stampa specificato. Si chiama quindi la funzione FindNextPrinterChangeNotification per recuperare informazioni sulla modifica e per reimpostare l'oggetto di notifica delle modifiche da usare nell'operazione di attesa successiva.
Sintassi
HANDLE FindFirstPrinterChangeNotification(
_In_ HANDLE hPrinter,
DWORD fdwFilter,
DWORD fdwOptions,
_In_opt_ LPVOID pPrinterNotifyOptions
);
Parametri
-
hPrinter [in]
-
Handle per la stampante o il server di stampa da monitorare. Usare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.
-
fdwFilter
-
Le condizioni che causano l'immissione dello stato segnalato dall'oggetto di notifica di modifica. Una notifica di modifica si verifica quando vengono soddisfatte una o più delle condizioni specificate. Il parametro fdwFilter può essere zero se pPrinterNotifyOptions non è NULL.
Questo parametro può essere uno o più dei valori seguenti.
Valore Significato - PRINTER_CHANGE_FORM
Notifica delle modifiche apportate a un modulo. È possibile impostare questo flag generale o uno o più dei flag specifici seguenti:
- PRINTER_CHANGE_ADD_FORM
- PRINTER_CHANGE_SET_FORM
- PRINTER_CHANGE_DELETE_FORM
- PRINTER_CHANGE_JOB
Notificare le modifiche apportate a un processo. È possibile impostare questo flag generale o uno o più dei flag specifici seguenti:
- PRINTER_CHANGE_ADD_JOB
- PRINTER_CHANGE_SET_JOB
- PRINTER_CHANGE_DELETE_JOB
- PRINTER_CHANGE_WRITE_JOB
- PRINTER_CHANGE_PORT
Notificare le modifiche apportate a una porta. È possibile impostare questo flag generale o uno o più dei flag specifici seguenti:
- PRINTER_CHANGE_ADD_PORT
- PRINTER_CHANGE_CONFIGURE_PORT
- PRINTER_CHANGE_DELETE_PORT
- PRINTER_CHANGE_PRINT_PROCESSOR
Notifica delle modifiche apportate a un processore di stampa. È possibile impostare questo flag generale o uno o più dei flag specifici seguenti:
- PRINTER_CHANGE_ADD_PRINT_PROCESSOR
- PRINTER_CHANGE_DELETE_PRINT_PROCESSOR
- PRINTER_CHANGE_PRINTER
Notifica delle modifiche apportate a una stampante. È possibile impostare questo flag generale o uno o più dei flag specifici seguenti:
- PRINTER_CHANGE_ADD_PRINTER
- PRINTER_CHANGE_SET_PRINTER
- PRINTER_CHANGE_DELETE_PRINTER
- PRINTER_CHANGE_FAILED_CONNECTION_PRINTER
- PRINTER_CHANGE_PRINTER_DRIVER
Notifica delle modifiche apportate a un driver della stampante. È possibile impostare questo flag generale o uno o più dei flag specifici seguenti:
- PRINTER_CHANGE_ADD_PRINTER_DRIVER
- PRINTER_CHANGE_SET_PRINTER_DRIVER
- PRINTER_CHANGE_DELETE_PRINTER_DRIVER
- PRINTER_CHANGE_ALL
Notifica se si verificano una delle modifiche precedenti. - PRINTER_CHANGE_SERVER
Windows 7: notificare le modifiche apportate al server.
Questo flag non è incluso nelle modifiche monitorate impostando il valore di PRINTER_CHANGE_ALL .Per le descrizioni dei flag più specifici nella tabella precedente, vedere la funzione FindNextPrinterChangeNotification .
-
fdwOptions
-
Flag che determina la categoria di stampanti per cui funzioneranno le notifiche.
Valore Significato - PRINTER_NOTIFY_CATEGORY_ALL
- 0x001000
FindNextPrinterChangeNotification restituisce notifiche per stampanti 2D e 3D. - PRINTER_NOTIFY_CATEGORY_3D
- 0x002000
FindNextPrinterChangeNotification restituisce notifiche solo per le stampanti 3D. Quando questo flag è impostato su zero (0), FindFirstPrinterChangeNotification funzionerà solo per le stampanti 2D. Si tratta del valore predefinito.
-
pPrinterNotifyOptions [in, facoltativo]
-
Puntatore a una struttura PRINTER_NOTIFY_OPTIONS . Il membro pTypes di questa struttura è una matrice di una o più strutture PRINTER_NOTIFY_OPTIONS_TYPE , ognuna delle quali specifica un campo informazioni sulla stampante da monitorare. Una notifica di modifica si verifica quando uno o più campi specificati cambiano. Quando si verifica una modifica, la funzione FindNextPrinterChangeNotification può recuperare le nuove informazioni sulla stampante. Questo parametro può essere NULL se fdwFilter è diverso da zero.
Per un elenco di campi che possono essere monitorati, vedere PRINTER_NOTIFY_OPTIONS_TYPE.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per un oggetto di notifica di modifica associato alla stampante o al server di stampa specificato.
Se la funzione ha esito negativo, il valore restituito è INVALID_HANDLE_VALUE.
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.
Per monitorare una stampante o un server di stampa, chiamare la funzione FindFirstPrinterChangeNotification , quindi usare l'handle dell'oggetto notifica delle modifiche restituito in una chiamata a una delle funzioni di attesa. Un'operazione di attesa in un oggetto di notifica di modifica viene soddisfatta quando l'oggetto di notifica di modifica entra nello stato segnalato. Il sistema segnala l'oggetto quando si verifica una o più modifiche specificate da fdwFilter o pPrinterNotifyOptions nella stampante monitorata o nel server di stampa.
Quando si chiama FindFirstPrinterChangeNotification, fdwFilter deve essere diverso da zero o pPrinterNotifyOptions non NULL. Se vengono specificati entrambi, le notifiche verranno eseguite per entrambe.
Quando un'operazione di attesa in un oggetto di notifica delle modifiche della stampante viene soddisfatta, chiamare la funzione FindNextPrinterChangeNotification per determinare la causa della notifica. Per una condizione specificata da fdwFilter, FindNextPrinterChangeNotification segnala la condizione o le condizioni modificate. Per un campo informazioni sulla stampante specificato da pPrinterNotifyOptions, FindNextPrinterChangeNotification segnala il campo o i campi che sono stati modificati e le nuove informazioni per questi campi. FindNextPrinterChangeNotification reimposta anche l'oggetto notifica delle modifiche allo stato non firmato in modo da poterlo usare in un'altra operazione di attesa per continuare a monitorare la stampante o il server di stampa.
Con un'eccezione, non chiamare la funzione FindNextPrinterChangeNotification se l'oggetto di notifica di modifica non è nello stato segnalato. Se la funzione wait restituisce il valore WAIT_TIMEOUT, l'oggetto change non è 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 .
Quando non è più necessario l'oggetto di notifica di modifica, chiuderlo chiamando la funzione FindClosePrinterChangeNotification .
I chiamanti di FindFirstPrinterChangeNotification devono assicurarsi che l'handle della stampante passato a FindFirstPrinterChangeNotification rimanga valido fino a quando non viene chiamato FindClosePrinterChangeNotification . Se l'handle della stampante viene chiuso prima dell'handle di notifica delle modifiche della stampante, non sarà possibile recapitare ulteriori notifiche.
FindFirstPrinterChangeNotification non invierà notifiche di modifica per le stampanti 3D agli handle del server.
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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|