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 |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
AddMonitorW (Unicode) und AddMonitorA (ANSI) |