Fonction SpoolerCopyFileEvent (winsplp.h)

Article
03/05/2024

La fonction SpoolerCopyFileEvent d’une DLL de point et d’impression reçoit des notifications d’événements associés à la copie de fichiers associés à la file d’attente d’impression vers un client d’impression, lorsque le client se connecte à un serveur d’impression.

Syntaxe

BOOL SpoolerCopyFileEvent(
  [in] LPWSTR pszPrinterName,
  [in] LPWSTR pszKey,
  [in] DWORD  dwCopyFileEvent
);

Paramètres

[in] pszPrinterName

Pointeur fourni par l’appelant vers une chaîne représentant le nom de l’imprimante.

[in] pszKey

Pointeur fourni par l’appelant vers une chaîne représentant une sous-clé sous la clé de Registre CopyFiles de l’imprimante. Cette sous-clé identifie le composant auquel appartient la DLL Point et Print.

[in] dwCopyFileEvent

Indicateur fourni par l’appelant qui identifie l’événement signalé. Les valeurs d’indicateur valides sont contenues dans le tableau suivant.

Indicateur	En cas de réception	Emplacement de réception
COPYFILE_EVENT_ADD_PRINTER_CONNECTION	Une fois qu’une application cliente a appelé AddPrinterConnection.	Copie cliente de `SpoolerCopyFileEvent`. Le contexte appelant est l’application cliente.
COPYFILE_EVENT_DELETE_PRINTER	Une fois qu’un appel à DeletePrinter a été effectué.	Copie cliente de `SpoolerCopyFileEvent`. Le contexte d’appel est le spouleur du client.
COPYFILE_EVENT_DELETE_PRINTER_CONNECTION	Une fois qu’une application cliente a appelé DeletePrinterConnection.	Copie cliente de `SpoolerCopyFileEvent`. Le contexte appelant est l’application cliente.
COPYFILE_EVENT_FILES_CHANGED	Une fois que le client a téléchargé les fichiers spécifiés sous la sous-clé pszKey de la clé de Registre CopyFiles de l’imprimante.	Copie cliente de `SpoolerCopyFileEvent`. Le contexte d’appel est le spouleur du client.
COPYFILE_EVENT_SET_PRINTER_DATAEX	Une fois qu’un appel à SetPrinterDataEx a été traité sur le serveur.	Copie serveur de `SpoolerCopyFileEvent`. Le contexte appelant est l’application cliente, par emprunt d’identité.

Valeur retournée

Si la fonction rencontre des erreurs, la fonction doit retourner FALSE. Dans le cas contraire, elle doit retourner TRUE.

Remarques

Toutes les DLL Point et Print doivent exporter une fonction SpoolerCopyFileEvent , appelée par le spouleur d’impression. Son objectif est de permettre à une DLL de point et d’impression d’être informée des événements liés au téléchargement de fichiers associés à la file d’attente d’impression, d’un serveur d’impression vers un système client, lorsqu’une application sur le client se connecte au serveur. Pour obtenir une description complète des étapes impliquées dans la création d’une connexion Point et Print, consultez Point et Impression de prise en charge.

Une DLL Point et Print s’exécute à la fois sur le serveur et le client. La fonction SpoolerCopyFileEvent peut déterminer où elle s’exécute en lisant le contenu de dwCopyFileEvent, qui fournit un indicateur indiquant l’événement. La fonction doit traiter l’événement et retourner. Si aucun traitement n’est nécessaire, la fonction doit simplement retourner TRUE.

Si dwCopyFileEvent est COPYFILE_EVENT_ADD_PRINTER_CONNECTION ou COPYFILE_EVENT_ADD_PRINTER_CONNECTION, la chaîne fournie par pszPrinterName inclut le nom du serveur.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	winsplp.h (inclure Winsplp.h)
Bibliothèque	Mscms.lib
DLL	Mscms.dll

Voir aussi

GenerateCopyFilePaths

Share via