Funzione SpoolerCopyFileEvent (winsplp.h)
Una funzione SpoolerCopyFileEvent di una DLL point e print riceve notifiche di eventi associati alla copia di 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 chiave del Registro di sistema CopyFiles della stampante. 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.
| Contrassegno | Al momento della ricezione | Posizione in cui è stato 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 aver effettuato 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 chiave del Registro di sistema CopyFiles della stampante. | 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.
Commenti
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 and Print viene eseguita sia nel server che nel 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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | winsplp.h (include Winsplp.h) |
| Libreria | Mscms.lib |
| DLL | Mscms.dll |