Freigeben über


AddMonitor-Funktion

Die AddMonitor-Funktion installiert einen lokalen Portmonitor und verknüpft die Konfigurations-, Daten- und Überwachungsdateien.

Syntax

BOOL AddMonitor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pMonitors
);

Parameter

pName [in]

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Servers angibt, auf dem der Monitor installiert werden soll. Bei Systemen, die nur die lokale Installation von Monitoren unterstützen, sollte diese Zeichenfolge NULL sein.

Ebene [in]

Die Version der -Struktur, auf die pMonitors zeigt. Dieser Wert muss 2 sein.

pMonitors [in]

Ein Zeiger auf eine MONITOR_INFO_2-Struktur . Wenn der pEnvironment-Member der pMonitors-StrukturNULL ist, wird die aktuelle Umgebung des Aufrufers (Client) und nicht des Ziels (Server) verwendet.

Beachten Sie, dass der Aufruf fehlschlägt, wenn die Umgebung nicht mit der Umgebung des Servers übereinstimmt. Das heißt, Sie können nur einen Monitor hinzufügen, der für die Architektur des Servers geschrieben wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Bemerkungen

Hinweis

Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückgegeben wird. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu führen, dass die Anwendung nicht mehr reagiert.

Der Aufrufer muss über das SeLoadDriverPrivilege verfügen.

Bevor eine Anwendung die AddMonitor-Funktion aufruft, müssen alle dateien, die für den Monitor erforderlich sind, in das Verzeichnis SYSTEM32 kopiert werden.

Rufen Sie die Funktion EnumMonitors auf, um die derzeit installierten Portmonitore zu ermitteln.

Um einen von AddMonitor hinzugefügten Monitor zu entfernen, rufen Sie die DeleteMonitor-Funktion auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Winspool.h (Einschließen von Windows.h)
Bibliothek
Winspool.lib
DLL
Winspool.drv
Unicode- und ANSI-Name
AddMonitorW (Unicode) und AddMonitorA (ANSI)

Siehe auch

Drucken

Druckspooler-API-Funktionen

DeleteMonitor

EnumMonitors

MONITOR_INFO_2