_Net_Share_StatisticsGetSvr
Beschreibung anzeigen in
Ermittelt die Verbindungsstatistik eines Servers
#include <NetShare.au3>
_Net_Share_StatisticsGetSvr ( [$sServer = ""] )
Parameter
| $sServer | [optional] Legt den DNS- oder NetBIOS-Namen des Remote-Servers fest, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter leer ist, wird der lokale Computer verwendet. |
Rückgabewert
| Erfolg: | Array mit dem folgenden Format: [ 0] - Zeit, zu der die Datensammlung begonnen wurde. Der Wert wird die Anzahl der Sekunden gespeichert, die seit dem 1. Januar 1970 00:00:00 vergangen sind. [ 1] - Gibt an, wie oft eine Datei auf dem Server geöffnet wurden [ 2] - Gibt an, wie oft Geräte auf dem Server geöffnet wurden [ 3] - Gibt an, wie oft ein Druckauftrag in die Warteschlange gestellt wurde [ 4] - Gibt an, wie oft eine Server-Sitzung gestartet wurde [ 5] - Gibt an, wie oft eine Server-Sitzung getrennt wurde [ 6] - Gibt an, wie oft eine Server-Sitzung mit einem Fehler abgebrochen wurde [ 7] - Gibt an, wie oft Passwort-Verstöße auf dem Server aufgetreten sind [ 8] - Gibt an, wie oft Fehler bei Zugriffsberechtigungen auf dem Server aufgetreten sind [ 9] - Gibt an, wie oft Systemfehler auf dem Server aufgetreten sind [10] - Anzahl der Bytes, die der Server über das Netzwerk verschickt hat [11] - Anzahl der Bytes, die der Server aus dem das Netzwerk empfangen hat [12] - Gibt die durchschnittliche Antwortzeit des Servers an (in Millisekunden) [13] - Gibt an, wie oft der Server einen Anfrage-Puffer benötigte, ihn aber nicht reservieren konnte [14] - Gibt an, wie oft der Server einen großen Puffer benötigte, ihn aber nicht reservieren konnte |
| Fehler: | Setzt das @error Flag auf ungleich null |
Bemerkungen
Es ist keine besondere Gruppenmitgliedschaft notwendig, um Server-Statistiken zu erhalten. Aber nur Mitglieder der lokalen
Administrator- oder Server-Operator-Gruppe können diese Funktion erfolgreich auf einem Remote Server ausführen.
Verwandte Funktionen
Siehe auch
Suche nach NetStatisticsGet in der MSDN Bibliothek.
Beispiel
#include <GuiConstantsEx.au3>
#include <NetShare.au3>
#include <WindowsConstants.au3>
Global $g_idMemo
Example()
Func Example()
Local $aInfo
; Erstellt eine GUI
GUICreate("_Net_Share_StatisticsGetSvr", 400, 300)
; Erstellt ein Memo-Control
$g_idMemo = GUICtrlCreateEdit("", 2, 2, 396, 296, $WS_VSCROLL)
GUICtrlSetFont($g_idMemo, 9, 400, 0, "Courier New")
GUISetState(@SW_SHOW)
; Erstellt die Server-Statistiken
$aInfo = _Net_Share_StatisticsGetSvr(@ComputerName)
MemoWrite("Start der Statistik .........................: " & $aInfo[0])
MemoWrite("Zeit der Dateiöffnung .......................: " & $aInfo[1])
MemoWrite("Zeit der Geräteöffnung ......................: " & $aInfo[2])
MemoWrite("Gespeicherte Druckaufträge ..................: " & $aInfo[3])
MemoWrite("Start der Sitzung ...........................: " & $aInfo[4])
MemoWrite("Sitzung unterbrochen ........................: " & $aInfo[5])
MemoWrite("Sitzungsfehler ..............................: " & $aInfo[6])
MemoWrite("Passwort-Verletzungen .......................: " & $aInfo[7])
MemoWrite("Rechte-Fehler ...............................: " & $aInfo[8])
MemoWrite("Server-System-Fehler ........................: " & $aInfo[9])
MemoWrite("Über das Netzwerk gesendete Bytes ...........: " & $aInfo[10])
MemoWrite("Über das Netzwerk empfangene Bytes ..........: " & $aInfo[11])
MemoWrite("Durchschnittliche Antwortzeit des Servers ...: " & $aInfo[12])
MemoWrite('"Req Buffer"-Fehler .........................: ' & $aInfo[13])
MemoWrite('"Big Buffer"-Fehler .........................: ' & $aInfo[14])
; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc ;==>Example
; Schreibt eine Nachricht in das Memo
Func MemoWrite($sMessage = "")
GUICtrlSetData($g_idMemo, $sMessage & @CRLF, 1)
EndFunc ;==>MemoWrite