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.

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 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é.

Valeur de retour

Si la fonction rencontre des erreurs, la fonction doit retourner FALSE. Sinon, elle doit retourner TRUE.

Remarques

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.

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête winsplp.h (include Winsplp.h)
bibliothèque Mscms.lib
DLL Mscms.dll

Voir aussi

GenerateCopyFilePaths