Fonction SpoolerCopyFileEvent (winsplp.h)
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 |