SpoolerCopyFileEvent-Funktion (winsplp.h)

Die SpoolerCopyFileEvent-Funktion einer Point-and-Print-DLL empfängt Benachrichtigungen über Ereignisse, die mit der Druckwarteschlange verknüpfte Dateien auf einen Druckclient kopieren, wenn der Client eine Verbindung mit einem Druckserver herstellt.

Syntax

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

Parameter

[in] pszPrinterName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die den Druckernamen darstellt.

[in] pszKey

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen Unterschlüssel unter dem Registrierungsschlüssel CopyFiles des Druckers darstellt. Dieser Unterschlüssel identifiziert die Komponente, zu der die Point and Print DLL gehört.

[in] dwCopyFileEvent

Vom Aufrufer bereitgestelltes Flag, das das gemeldete Ereignis identifiziert. Gültige Flagwerte sind in der folgenden Tabelle enthalten.

Flag	Beim Empfang	Empfangsort
COPYFILE_EVENT_ADD_PRINTER_CONNECTION	Nachdem eine Clientanwendung AddPrinterConnection aufgerufen hat.	Clientkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist die Clientanwendung.
COPYFILE_EVENT_DELETE_PRINTER	Nach einem Aufruf von DeletePrinter .	Clientkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist der Spooler des Clients.
COPYFILE_EVENT_DELETE_PRINTER_CONNECTION	Nachdem eine Clientanwendung DeletePrinterConnection aufgerufen hat.	Clientkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist die Clientanwendung.
COPYFILE_EVENT_FILES_CHANGED	Nachdem der Client die dateien heruntergeladen hat, die unter dem Unterschlüssel pszKey des Registrierungsschlüssels CopyFiles des Druckers angegeben sind.	Clientkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist der Spooler des Clients.
COPYFILE_EVENT_SET_PRINTER_DATAEX	Nachdem ein Aufruf von SetPrinterDataEx auf dem Server verarbeitet wurde.	Serverkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist die Clientanwendung durch Identitätswechsel.

Rückgabewert

Wenn bei der Funktion Fehler auftreten, sollte die Funktion FALSE zurückgeben. Andernfalls sollte true zurückgegeben werden.

Hinweise

Alle Point- und Print-DLLs müssen eine SpoolerCopyFileEvent-Funktion exportieren, die vom Druckspooler aufgerufen wird. Ihr Zweck besteht darin, eine Point-and-Print-DLL über Ereignisse im Zusammenhang mit dem Herunterladen von mit der Druckwarteschlange verbundenen Dateien von einem Druckserver auf ein Clientsystem zu benachrichtigen, wenn eine Anwendung auf dem Client eine Verbindung mit dem Server herstellt. Eine vollständige Beschreibung der Schritte zum Erstellen einer Point-and-Print-Verbindung finden Sie unter Unterstützen von Punkt und Drucken.

Eine Point- und Print-DLL wird sowohl auf dem Server als auch auf dem Client ausgeführt. Die SpoolerCopyFileEvent-Funktion kann bestimmen, wo sie ausgeführt wird, indem sie den Inhalt von dwCopyFileEvent liest, das ein Flag bereitstellt, das das Ereignis angibt. Die Funktion sollte das Ereignis verarbeiten und zurückgeben. Wenn keine Verarbeitung erforderlich ist, sollte die Funktion einfach TRUE zurückgeben.

Wenn dwCopyFileEvent COPYFILE_EVENT_ADD_PRINTER_CONNECTION oder COPYFILE_EVENT_ADD_PRINTER_CONNECTION ist, enthält die von pszPrinterName bereitgestellte Zeichenfolge den Servernamen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	winsplp.h (winsplp.h einschließen)
Bibliothek	Mscms.lib
DLL	Mscms.dll

Weitere Informationen

GenerateCopyFilePaths