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

Consulte también

GenerateCopyFilePaths