Функция SpoolerCopyFileEvent (winsplp.h)
spoolerCopyFileEvent библиотеки DLL получает уведомления о событиях, связанных с копированием файлов очереди печати в клиент печати, когда клиент подключается к серверу печати.
Синтаксис
BOOL SpoolerCopyFileEvent(
[in] LPWSTR pszPrinterName,
[in] LPWSTR pszKey,
[in] DWORD dwCopyFileEvent
);
Параметры
[in] pszPrinterName
Вызывающий указатель на строку, представляющую имя принтера.
[in] pszKey
Вызывающий указатель на строку, представляющую вложенный ключ в разделе реестра принтера CopyFiles. Этот подраздел идентифицирует компонент, к которому принадлежит библиотека DLL "Точка" и "Печать".
[in] dwCopyFileEvent
Предоставленный вызывающим флаг, определяющий сообщаемое событие. Допустимые значения флага содержатся в следующей таблице.
| Флаг | При получении | Где получено |
|---|---|---|
| COPYFILE_EVENT_ADD_PRINTER_CONNECTION | После вызова клиентского приложения AddPrinterConnection. | Копия клиента SpoolerCopyFileEvent. Контекст вызова — клиентское приложение. |
| COPYFILE_EVENT_DELETE_PRINTER | После вызова DeletePrinter был выполнен. | Копия клиента SpoolerCopyFileEvent. Контекст вызова — это средство spooler клиента. |
| COPYFILE_EVENT_DELETE_PRINTER_CONNECTION | После вызова клиентского приложения DeletePrinterConnection. | Копия клиента SpoolerCopyFileEvent. Контекст вызова — клиентское приложение. |
| COPYFILE_EVENT_FILES_CHANGED | После скачивания файлов, указанных в подразделе pszKey раздела реестра принтера CopyFiles. | Копия клиента SpoolerCopyFileEvent. Контекст вызова — это средство spooler клиента. |
| COPYFILE_EVENT_SET_PRINTER_DATAEX | После вызова SetPrinterDataEx был обработан на сервере. | Копия сервера SpoolerCopyFileEvent. Контекст вызова — это клиентское приложение, олицетворение. |
Возвращаемое значение
Если функция сталкивается с ошибками, функция должна вернуть FALSE. В противном случае он должен возвращать TRUE.
Замечания
Все библиотеки DLL точки и печати должны экспортировать функцию SpoolerCopyFileEvent, которая вызывается диспетчером печати. Его целью является разрешение библиотеки DLL "Точка" и "Печать" получать уведомления о событиях, связанных с загрузкой файлов, связанных с очередью печати, с сервера печати в клиентную систему, когда приложение на клиенте подключается к серверу. Полное описание шагов, связанных с созданием подключения "Точка и печать", см. в разделе поддержки точки и печати.
Библиотека DLL "Точка" и "Печать" выполняется как на сервере, так и на клиенте. Функция SpoolerCopyFileEvent может определить, где она выполняется, считывая содержимое dwCopyFileEvent, которая предоставляет флаг, указывающий на событие. Функция должна обрабатывать событие и возвращать его. Если обработка не требуется, функция должна возвращать только TRUE.
Если dwCopyFileEvent COPYFILE_EVENT_ADD_PRINTER_CONNECTION или COPYFILE_EVENT_ADD_PRINTER_CONNECTION, строка, предоставляемая pszPrinterName включает имя сервера.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | winsplp.h (include Winsplp.h) |
| библиотеки | Mscms.lib |
| DLL | Mscms.dll |