AddMonitor-Funktion
Die Funktion AddMonitor 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 auf NULL endende Zeichenfolge, die den Namen des Servers angibt, auf dem der Monitor installiert werden soll. Für Systeme, die nur die lokale Installation von Monitoren unterstützen, sollte diese Zeichenfolge NULL sein.
-
Ebene [ In]
-
Die Version der -Struktur, auf die pMonitors verweist. Dieser Wert muss 2 sein.
-
pMonitors [ In]
-
Ein Zeiger auf eine MONITOR _ INFO _ 2-Struktur. Wenn der pEnvironment-Member der pMonitors-Struktur NULL 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. Sie können also nur einen Monitor hinzufügen, der für die Architektur des Servers geschrieben wurde.
Rückgabewert
Wenn die Funktion erfolgreich ausgeführt wird, ist der Rückgabewert ein Wert ungleich 0 (null).
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Bemerkungen
Hinweis
Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren für Druckertreiber ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion über einen Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, kann dazu bringen, dass die Anwendung scheinbar nicht reagiert.
Der Aufrufer muss über seLoadDriverPrivilege verfügen.
Bevor eine Anwendung die AddMonitor-Funktion aufruft, müssen alle vom Monitor benötigten Dateien in das Verzeichnis SYSTEM32 kopiert werden.
Rufen Sie die EnumMonitors-Funktion auf, um die derzeit installierten Portmonitore zu ermitteln.
Um einen von AddMonitor hinzugefügten Monitor zu entfernen, rufen Sie die DeleteMonitor-Funktion auf.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
AddMonitorW (Unicode) und AddMonitorA (ANSI) |