Función SpoolerCopyFileEvent (winsplp.h)
Una función SpoolerCopyFile Event 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 el CopyFiles de la impresora clave del Registro. 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.
| Bandera | Cuando se recibe | Dónde se recibió |
|---|---|---|
| COPYFILE_EVENT_ADD_PRINTER_CONNECTION | Después de llamar a una aplicación cliente 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 la cola del cliente. |
| COPYFILE_EVENT_DELETE_PRINTER_CONNECTION | Después de llamar a una aplicación cliente DeletePrinterConnection. | Copia de cliente de SpoolerCopyFileEvent. El contexto de llamada es la aplicación cliente. |
| COPYFILE_EVENT_FILES_CHANGED | Después de que el cliente haya descargado los archivos especificados en la pszKey subclave de la CopyFiles de la impresora clave del Registro. | Copia de cliente de SpoolerCopyFileEvent. El contexto de llamada es la cola del cliente. |
| COPYFILE_EVENT_SET_PRINTER_DATAEX | Una vez 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, mediante suplantación. |
Valor devuelto
Si la función encuentra errores, la función debe devolver FALSE. De lo contrario, debe devolver TRUE.
Observaciones
Todos los archivos DLL de punto e impresión de 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 imprimir.
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 es COPYFILE_EVENT_ADD_PRINTER_CONNECTION o COPYFILE_EVENT_ADD_PRINTER_CONNECTION, la cadena proporcionada por pszPrinterName incluye el nombre del servidor.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | winsplp.h (incluya Winsplp.h) |
| biblioteca de | Mscms.lib |
| DLL de | Mscms.dll |