SpoolerCopyFileEvent-Funktion (winsplp.h)
Die SpoolerCopyFileEvent Funktion einer Point- und Print-DLL empfängt Benachrichtigungen über Ereignisse, die dem Kopieren von mit der Druckwarteschlange verknüpften Dateien in einen Druckclient verbunden sind, 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 CopyFiles Registrierungsschlüssel des Druckers darstellt. Dieser Unterschlüssel identifiziert die Komponente, zu der die Point- und Print-DLL gehört.
[in] dwCopyFileEvent
Vom Aufrufer bereitgestelltes Flag, das das gemeldete Ereignis identifiziert. Gültige Flagwerte sind in der folgenden Tabelle enthalten.
| Flagge | Wann empfangen | Wo empfangen |
|---|---|---|
| COPYFILE_EVENT_ADD_PRINTER_CONNECTION | Nachdem eine Clientanwendung AddPrinterConnectionaufgerufen hat. | Clientkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist die Clientanwendung. |
| COPYFILE_EVENT_DELETE_PRINTER | Nachdem ein Aufruf von DeletePrinter erfolgt ist. | Clientkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist der Spooler des Clients. |
| COPYFILE_EVENT_DELETE_PRINTER_CONNECTION | Nachdem eine Clientanwendung DeletePrinterConnectionaufgerufen hat. | Clientkopie von SpoolerCopyFileEvent. Der aufrufende Kontext ist die Clientanwendung. |
| COPYFILE_EVENT_FILES_CHANGED | Nachdem der Client die unter dem pszKey angegebenen Dateien heruntergeladen hat, Unterschlüssel des CopyFiles des Druckers Registrierungsschlüssels. | 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.
Bemerkungen
Alle Zeige- und Druck-DLLs müssen eine SpoolerCopyFileEvent-Funktion exportieren, die vom Druckspooler aufgerufen wird. Der Zweck besteht darin, eine Point- und Print-DLL über Ereignisse im Zusammenhang mit dem Herunterladen von dateien in der Druckwarteschlange zu informieren, von einem Druckserver auf ein Clientsystem, wenn eine Anwendung auf dem Client eine Verbindung mit dem Server herstellt. Eine vollständige Beschreibung der Schritte zum Erstellen einer Punkt- und Druckverbindung finden Sie unter Unterstützende Punkt- und Druck-.
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 der Inhalt dwCopyFileEventgelesen wird, das ein Flag angibt, das das Ereignis angibt. Die Funktion sollte das Ereignis verarbeiten und zurückgeben. Wenn keine Verarbeitung erforderlich ist, sollte die Funktion nur 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- | Universal |
| Header- | winsplp.h (include Winsplp.h) |
| Library | Mscms.lib |
| DLL- | Mscms.dll |