Функция SpoolerCopyFileEvent (winsplp.h)

Статья
03/13/2023

Функция SpoolerCopyFileEvent библиотеки dll point и print получает уведомления о событиях, связанных с копированием файлов, связанных с очередью печати, в клиент печати, когда клиент подключается к серверу печати.

Синтаксис

BOOL SpoolerCopyFileEvent(
  [in] LPWSTR pszPrinterName,
  [in] LPWSTR pszKey,
  [in] DWORD  dwCopyFileEvent
);

Параметры

[in] pszPrinterName

Предоставленный вызывающим оператором указатель на строку, представляющую имя принтера.

[in] pszKey

Предоставленный вызывающим элементом указатель на строку, представляющую подраздел в разделе реестра CopyFiles принтера. Этот подраздел идентифицирует компонент, к которому принадлежат библиотеки DLL-библиотеки Point и Print.

[in] dwCopyFileEvent

Флаг, предоставленный вызывающим абонентом, который идентифицирует событие, о котором сообщается. Допустимые значения флагов содержатся в следующей таблице.

Flag	При получении	Где получено
COPYFILE_EVENT_ADD_PRINTER_CONNECTION	После вызова AddPrinterConnection в клиентском приложении.	Клиентская копия `SpoolerCopyFileEvent`. Контекст вызова — это клиентское приложение.
COPYFILE_EVENT_DELETE_PRINTER	После вызова DeletePrinter .	Клиентская копия `SpoolerCopyFileEvent`. Контекст вызова — это диспетчер очереди клиента.
COPYFILE_EVENT_DELETE_PRINTER_CONNECTION	После того, как клиентское приложение вызовет DeletePrinterConnection.	Клиентская копия `SpoolerCopyFileEvent`. Контекст вызова — это клиентское приложение.
COPYFILE_EVENT_FILES_CHANGED	После скачивания клиентом файлов, указанных в подразделе pszKey раздела реестра CopyFiles принтера.	Клиентская копия `SpoolerCopyFileEvent`. Контекст вызова — это диспетчер очереди клиента.
COPYFILE_EVENT_SET_PRINTER_DATAEX	После обработки вызова SetPrinterDataEx на сервере.	Серверная `SpoolerCopyFileEvent`копия . Вызывающий контекст — это клиентское приложение путем олицетворения.

Возвращаемое значение

Если функция обнаруживает ошибки, функция должна возвращать значение FALSE. В противном случае он должен возвращать значение TRUE.

Все библиотеки DLL для точек и печати должны экспортировать функцию SpoolerCopyFileEvent , которая вызывается диспетчером очереди печати. Его цель — разрешить dll-файлам Point и Print получать уведомления о событиях, связанных с загрузкой файлов, связанных с очередью печати, с сервера печати в клиентную систему, когда приложение на клиенте подключается к серверу. Полное описание действий, связанных с созданием подключения point и print, см. в разделе Поддержка point и print.

Библиотека DLL для точек и печати выполняется как на сервере, так и на клиенте. Функция SpoolerCopyFileEvent может определить, где она выполняется, считывая содержимое dwCopyFileEvent, которое предоставляет флаг, указывающий на событие. Функция должна обработать событие и вернуть . Если обработка не требуется, функция должна просто возвращать значение TRUE.

Если параметр dwCopyFileEvent COPYFILE_EVENT_ADD_PRINTER_CONNECTION или COPYFILE_EVENT_ADD_PRINTER_CONNECTION, строка, предоставляемая pszPrinterName , содержит имя сервера.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	winsplp.h (включая Winsplp.h)
Библиотека	Mscms.lib
DLL	Mscms.dll

См. также раздел

GenerateCopyFilePaths

Поделиться через