Funzione SpoolerCopyFileEvent (winsplp.h)
La funzione SpoolerCopyFileEvent di una DLL point e print riceve le notifiche degli eventi associati alla copia dei file associati alla coda di stampa in un client di stampa, quando il client si connette a un server di stampa.
Sintassi
BOOL SpoolerCopyFileEvent(
[in] LPWSTR pszPrinterName,
[in] LPWSTR pszKey,
[in] DWORD dwCopyFileEvent
);
Parametri
[in] pszPrinterName
Puntatore fornito dal chiamante a una stringa che rappresenta il nome della stampante.
[in] pszKey
Puntatore fornito dal chiamante a una stringa che rappresenta una sottochiave nella CopyFiles della stampante chiave del Registro di sistema. Questa sottochiave identifica il componente a cui appartiene la DLL Point and Print.
[in] dwCopyFileEvent
Flag fornito dal chiamante che identifica l'evento segnalato. I valori di flag validi sono contenuti nella tabella seguente.
| Bandiera | Quando ricevuto | Dove ricevuto |
|---|---|---|
| COPYFILE_EVENT_ADD_PRINTER_CONNECTION | Dopo che un'applicazione client ha chiamato AddPrinterConnection. | Copia client di SpoolerCopyFileEvent. Il contesto chiamante è l'applicazione client. |
| COPYFILE_EVENT_DELETE_PRINTER | Dopo che è stata effettuata una chiamata a DeletePrinter. | Copia client di SpoolerCopyFileEvent. Il contesto chiamante è lo spooler del client. |
| COPYFILE_EVENT_DELETE_PRINTER_CONNECTION | Dopo che un'applicazione client ha chiamato DeletePrinterConnection. | Copia client di SpoolerCopyFileEvent. Il contesto chiamante è l'applicazione client. |
| COPYFILE_EVENT_FILES_CHANGED | Dopo che il client ha scaricato i file specificati nella sottochiave pszKey della CopyFiles della stampante chiave del Registro di sistema. | Copia client di SpoolerCopyFileEvent. Il contesto chiamante è lo spooler del client. |
| COPYFILE_EVENT_SET_PRINTER_DATAEX | Dopo l'elaborazione di una chiamata a SetPrinterDataEx nel server. | Copia server di SpoolerCopyFileEvent. Il contesto chiamante è l'applicazione client, in base alla rappresentazione. |
Valore restituito
Se la funzione rileva errori, la funzione deve restituire FALSE. In caso contrario, deve restituire TRUE.
Osservazioni
Tutte le DLL point e print devono esportare una funzione SpoolerCopyFileEvent, chiamata dallo spooler di stampa. Lo scopo è consentire a una DLL point e print di ricevere una notifica degli eventi correlati al download dei file associati alla coda di stampa, da un server di stampa a un sistema client, quando un'applicazione nel client si connette al server. Per una descrizione completa dei passaggi necessari per la creazione di una connessione punto e stampa, vedere punto di supporto e stampa.
Una DLL point e print viene eseguita sia sul server che sul client. La funzione SpoolerCopyFileEvent può determinare dove viene eseguita leggendo il contenuto di dwCopyFileEvent, che fornisce un flag che indica l'evento. La funzione deve elaborare l'evento e restituire. Se non è necessaria alcuna elaborazione, la funzione deve restituire solo TRUE.
Se dwCopyFileEvent è COPYFILE_EVENT_ADD_PRINTER_CONNECTION o COPYFILE_EVENT_ADD_PRINTER_CONNECTION, la stringa fornita da pszPrinterName include il nome del server.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | winsplp.h (includere Winsplp.h) |
| libreria | Mscms.lib |
| dll | Mscms.dll |