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 |