InitializePrintMonitor-Funktion (winsplp.h)
Die InitializePrintMonitor Funktion ist veraltet und wird nur zu Kompatibilitätszwecken unterstützt. Neue Druckmonitore sollten InitializePrintMonitor2 implementieren, damit sie mit Druckserverclustern verwendet werden können.
Die InitializePrintMonitor Funktion eines Druckmonitors initialisiert einen Druckmonitor.
Syntax
LPMONITOREX InitializePrintMonitor(
[in] LPWSTR pRegistryRoot
);
Parameter
[in] pRegistryRoot
Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen Registrierungspfad identifiziert, den der Druckmonitor zum Speichern von monitorspezifischen Werten verwenden kann.
Rückgabewert
Wenn der Vorgang erfolgreich ist, sollte die Funktion einen Zeiger auf eine MONITOREX- Struktur zurückgeben. Andernfalls sollte die Funktion SetLastError (in der Microsoft Windows SDK-Dokumentation beschrieben) aufrufen, um einen Fehlercode festzulegen und NULL-zurückzugeben.
Bemerkungen
Die InitializePrintMonitor--Funktion muss von Sprachmonitoren und von Portmonitor-Server-DLLs exportiert werden. Die Funktion wird unmittelbar nach dem Laden der Monitor-DLL aufgerufen und erst wieder aufgerufen, wenn die DLL neu geladen wird. Es dient dazu, dem Monitor die Initialisierung selbst zu ermöglichen und den Spooler mit Zeigern auf interne Monitorfunktionen bereitzustellen. Funktionszeiger sind in einer MONITOR--Struktur enthalten, auf die über die MONITOREX--Funktion verwiesen wird.
Der pRegistryRoot--Parameter stellt einen Zeiger eine Zeichenfolge bereit, die den Pfad zu einem MonitorName Registrierungsschlüssel darstellt, wobei MonitorName der Monitorname ist, der angegeben wurde, als die AddMonitor-Funktion des Spoolers Funktion aufgerufen wurde, um den Monitor hinzuzufügen. Der Monitor kann diesen Schlüssel verwenden, um monitorspezifische Wertnamen und -werte zu speichern. Wenn die DeleteMonitor-Funktion des Spoolers aufgerufen wird, löscht der Spooler den MonitorName-Schlüssel Schlüssel und alle darunter gespeicherten Werte. (Die funktionen AddMonitor und DeleteMonitor werden in der Windows SDK-Dokumentation beschrieben.)
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | winsplp.h (include Winsplp.h) |