SpoolerCopyFileEvent, fonction (winsplp.h)
La fonction SpoolerCopyFileEvent d’une DLL point et d’impression reçoit des notifications d’événements associés à la copie des fichiers associés à la file d’attente d’impression vers un client d’impression, lorsque le client se connecte à un serveur d’impression.
BOOL SpoolerCopyFileEvent(
[in] LPWSTR pszPrinterName,
[in] LPWSTR pszKey,
[in] DWORD dwCopyFileEvent
);
[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 CopyFiles de l’imprimante clé de Registre. 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.
Drapeau | Lorsqu’il est reçu | Où il a été reçu |
---|---|---|
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 | Après un appel à DeletePrinter a été effectué. | Copie cliente de SpoolerCopyFileEvent . Le contexte appelant 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 l’imprimante CopyFiles clé de Registre. | Copie cliente de SpoolerCopyFileEvent . Le contexte appelant est le spouleur du client. |
COPYFILE_EVENT_SET_PRINTER_DATAEX | Après un appel à SetPrinterDataEx a été traité sur le serveur. | Copie du serveur de SpoolerCopyFileEvent . Le contexte appelant est l’application cliente, par emprunt d’identité. |
Si la fonction rencontre des erreurs, la fonction doit retourner FALSE. Sinon, elle doit retourner TRUE.
Toutes les DLL point et impression 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 averti des événements liés au téléchargement des fichiers associés à la file d’attente d’impression, d’un serveur d’impression à 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 impression, consultez point de prise en charge etd’impression.
Une DLL point et d’impression s’exécute 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.
Exigence | Valeur |
---|---|
plateforme cible | Universel |
d’en-tête | winsplp.h (include Winsplp.h) |
bibliothèque | Mscms.lib |
DLL | Mscms.dll |