Función SpoolerCopyFileEvent (winsplp.h)
Una función SpoolerCopyFileEvent de un archivo DLL de punto e impresión recibe notificaciones de eventos asociados a la copia de archivos asociados a la cola de impresión en un cliente de impresión, cuando el cliente se conecta a un servidor de impresión.
Sintaxis
BOOL SpoolerCopyFileEvent(
[in] LPWSTR pszPrinterName,
[in] LPWSTR pszKey,
[in] DWORD dwCopyFileEvent
);
Parámetros
[in] pszPrinterName
Puntero proporcionado por el autor de la llamada a una cadena que representa el nombre de la impresora.
[in] pszKey
Puntero proporcionado por el autor de la llamada a una cadena que representa una subclave en la clave del Registro CopyFiles de la impresora. Esta subclave identifica el componente al que pertenece el archivo DLL Point e Print.
[in] dwCopyFileEvent
Marca proporcionada por el autor de la llamada que identifica el evento que se está notificando. Los valores de marca válidos se encuentran en la tabla siguiente.
| Marca | Cuándo se recibió | Dónde se recibió |
|---|---|---|
| COPYFILE_EVENT_ADD_PRINTER_CONNECTION | Después de que una aplicación cliente haya llamado AddPrinterConnection. | Copia de cliente de SpoolerCopyFileEvent. El contexto de llamada es la aplicación cliente. |
| COPYFILE_EVENT_DELETE_PRINTER | Después de realizar una llamada a DeletePrinter . | Copia de cliente de SpoolerCopyFileEvent. El contexto de llamada es el administrador de colas del cliente. |
| COPYFILE_EVENT_DELETE_PRINTER_CONNECTION | Después de que una aplicación cliente haya llamado DeletePrinterConnection. | Copia de cliente de SpoolerCopyFileEvent. El contexto de llamada es la aplicación cliente. |
| COPYFILE_EVENT_FILES_CHANGED | Una vez que el cliente haya descargado los archivos especificados en la subclave pszKey de la clave del Registro CopyFiles de la impresora. | Copia de cliente de SpoolerCopyFileEvent. El contexto de llamada es el administrador de colas del cliente. |
| COPYFILE_EVENT_SET_PRINTER_DATAEX | Después de que se haya procesado una llamada a SetPrinterDataEx en el servidor. | Copia del servidor de SpoolerCopyFileEvent. El contexto de llamada es la aplicación cliente, por suplantación. |
Valor devuelto
Si la función encuentra errores, la función debe devolver FALSE. De lo contrario, debe devolver TRUE.
Comentarios
Todos los archivos DLL de punto e impresión deben exportar una función SpoolerCopyFileEvent , a la que llama el administrador de trabajos de impresión. Su propósito es permitir que un archivo DLL de punto e impresión reciba notificaciones de eventos relacionados con la descarga de archivos asociados a la cola de impresión, desde un servidor de impresión a un sistema cliente, cuando una aplicación del cliente se conecta al servidor. Para obtener una descripción completa de los pasos implicados en la creación de una conexión de punto e impresión, consulte Punto auxiliar e Impresión.
Un archivo DLL de punto e impresión se ejecuta tanto en el servidor como en el cliente. La función SpoolerCopyFileEvent puede determinar dónde se ejecuta leyendo el contenido de dwCopyFileEvent, que proporciona una marca que indica el evento. La función debe procesar el evento y devolver. Si no es necesario procesar, la función solo debe devolver TRUE.
Si dwCopyFileEvent está COPYFILE_EVENT_ADD_PRINTER_CONNECTION o COPYFILE_EVENT_ADD_PRINTER_CONNECTION, la cadena proporcionada por pszPrinterName incluye el nombre del servidor.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | winsplp.h (incluya Winsplp.h) |
| Library | Mscms.lib |
| Archivo DLL | Mscms.dll |