InitializePrintMonitor-Funktion (winsplp.h)

  • Artikel

Die InitializePrintMonitor-Funktion ist veraltet und wird nur aus Kompatibilitätsgründen 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 aufrufen (in der Microsoft Windows SDK Dokumentation beschrieben), um einen Fehlercode festzulegen und NULL zurückzugeben.

Hinweise

Die InitializePrintMonitor-Funktion muss von Sprachmonitoren und portmonitorserver-DLLs exportiert werden. Die Funktion wird unmittelbar nach dem Laden der Monitor-DLL aufgerufen und erst dann erneut aufgerufen, wenn die DLL erneut geladen wird. Zweck ist es, dem Monitor zu ermöglichen, sich selbst zu initialisieren und dem Spooler Zeiger auf interne Überwachungsfunktionen bereitzustellen. Funktionszeiger sind in einer MONITOR-Struktur enthalten, auf die über die MONITOREX-Funktion verwiesen wird.

Der Parameter pRegistryRoot 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 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 Schlüssel MonitorName und alle darunter gespeicherten Werte. (Die Funktionen AddMonitor und DeleteMonitor werden in der Windows SDK Dokumentation beschrieben.)

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winsplp.h (winsplp.h einschließen)

Weitere Informationen

InitializePrintMonitorUI

MONITOREX