Funzione SpoolerCopyFileEvent (winsplp.h)

  • Articolo

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

Vedi anche

GenerateCopyFilePaths