_Net_Share_StatisticsGetWrk

Beschreibung anzeigen in

Ermittelt die Verbindungsstatistik einer Workstation

#include <NetShare.au3>
_Net_Share_StatisticsGetWrk ( [$sWorkStation = ""] )

Parameter

$sWorkStation

[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] - Anzahl der von der Workstation empfangenen Bytes
[ 2] - Anzahl der von der Workstation empfangenen Nachrichtenblöcke (SMBs)
[ 3] - Bytes, die durch Paging-I/O-Anfragen gelesen wurden
[ 4] - Bytes, die durch Non-Paging-I/O-Anfragen gelesen wurden
[ 5] - Bytes, die durch Cache-I/O-Anfragen gelesen wurden
[ 6] - Bytes, die durch Disk-I/O-Anfragen gelesen wurden
[ 7] - Anzahl der von der Workstation gesendeten Bytes
[ 8] - Anzahl der von der Workstation gesendeten Nachrichtenblöcke (SMBs)
[ 9] - Bytes, die durch Paging-I/O-Anfragen geschrieben wurden
[10] - Bytes, die durch Non-Paging-I/O-Anfragen geschrieben wurden
[11] - Bytes, die durch Cache-I/O-Anfragen geschrieben wurden
[12] - Bytes, die durch Disk-I/O-Anfragen geschrieben wurden
[13] - Netzwerkoperationen, deren Ausführung nicht gestartet werden konnte
[14] - Netzwerkoperationen, deren Ausführung nicht fertiggestellt werden konnte
[15] - Leseoperationen, die von der Workstation initiiert wurden
[16] - Leseoperationen mit wahlfreiem Zugriff, die von der Workstation initiiert wurden
[17] - Leseanfragen, welche die Workstation an Server gesendet hat
[18] - Leseanfragen, welche die Workstation an Server gesendet hat, deren Größe mindestens doppelt so groß wie der ausgehandelte Puffer des Servers war
[19] - Leseanfragen, welche die Workstation an Server gesendet hat, deren Größe kleiner als 1/4 der ausgehandelten Puffergröße des Servers war
[20] - Schreiboperationen, die von der Workstation initiiert wurden
[21] - Schreiboperationen mit wahlfreiem Zugriff, die von der Workstation initiiert wurden
[22] - Schreibanfragen, welche die Workstation an Server gesendet hat
[23] - Schreibanfragen, welche die Workstation an Server gesendet hat, deren Größe mindestens doppelt so groß wie der ausgehandelte Puffer des Servers war
[24] - Schreibanfragen, welche die Workstation an Server gesendet hat, deren Größe kleiner als 1/4 der ausgehandelten Puffergröße des Servers war
[25] - Raw-Leseanfragen durch die Workstation, die verweigert wurden
[26] - Raw-Schreibanfragen durch die Workstation, die verweigert wurden
[27] - Netzwerkfehler, die von der Workstation empfangen wurden
[28] - Sitzungen, die von der Workstation eingerichtet wurden
[29] - Anzahl der Fehlversuche der Workstation, eine Sitzung zu erstellen
[30] - Fehlerhafte Verbindungen
[31] - Erfolgreiche PCNET-Verbindungen
[32] - Erfolgreiche LanManager 20 Verbindungen
[33] - Erfolgreiche LanManager 21 Verbindungen
[34] - Erfolgreiche Windows NT Verbindungen
[35] - Anzahl der Trennungen durch einen Netzwerkserver
[36] - Anzahl der abgelaufenen Sitzungen auf der Workstation
[37] - Verbindungen, die von der Workstation eingerichtet wurden
[38] - Anzahl der Fehlversuche der Workstation, eine Verbindung herzustellen
[39] - Zurzeit noch nicht abgeschlossene Anfragen

Fehler:

Setzt das @error Flag auf ungleich null

Bemerkungen

Es ist keine besondere Gruppenmitgliedschaft notwendig, um Workstation-Statistiken zu erhalten. Aber nur Mitglieder der lokalen
Administrator- oder Server-Operator-Gruppe können diese Funktion erfolgreich auf einem Remote Server ausführen.

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("NetShare", 500, 650)

    ; Erstellt ein Memo Control
    $g_idMemo = GUICtrlCreateEdit("", 2, 2, 496, 646, $WS_VSCROLL)
    GUICtrlSetFont($g_idMemo, 9, 400, 0, "Courier New")
    GUISetState(@SW_SHOW)

    ; Ermittelt die Verbindungsstatistik der Workstation
    $aInfo = _Net_Share_StatisticsGetWrk(@ComputerName)
    MemoWrite("===================== NetStatisticsGetWrk =====================")
    MemoWrite("Aufzeichnung begonnen .....................: " & $aInfo[0])
    MemoWrite("Bytes empfangen ...........................: " & $aInfo[1])
    MemoWrite("SMBs empfangen ............................: " & $aInfo[2])
    MemoWrite("Paging-I/O-Bytes ..........................: " & $aInfo[3])
    MemoWrite("Non-paging-I/O-Bytes ......................: " & $aInfo[4])
    MemoWrite("Cache-I/O-Bytes ...........................: " & $aInfo[5])
    MemoWrite("Disk-I/O-Bytes ............................: " & $aInfo[6])
    MemoWrite("Bytes gesendet ............................: " & $aInfo[7])
    MemoWrite("SMBs gesendet .............................: " & $aInfo[8])
    MemoWrite("Paging-I/O-Bytes ..........................: " & $aInfo[9])
    MemoWrite("Non-paging-I/O-Bytes ......................: " & $aInfo[10])
    MemoWrite("Cache-I/O-Bytes ...........................: " & $aInfo[11])
    MemoWrite("Disk-I/O-Bytes ............................: " & $aInfo[12])
    MemoWrite("Fehlgeschlagene Operationen begonnen ......: " & $aInfo[13])
    MemoWrite("Fehlgeschlagene Operationen abgeschlossen .: " & $aInfo[14])
    MemoWrite("Lesevorgänge ..............................: " & $aInfo[15])
    MemoWrite("Lesevorgänge mit wahlfreiem Zugriff........: " & $aInfo[16])
    MemoWrite("Leseanfragen gesendet .....................: " & $aInfo[17])
    MemoWrite("Leseanfragen (groß) .......................: " & $aInfo[18])
    MemoWrite("Leseanfragen (klein) ......................: " & $aInfo[19])
    MemoWrite("Schreibvorgänge ...........................: " & $aInfo[20])
    MemoWrite("Schreibvorgänge mit wahlfreiem Zugriff.....: " & $aInfo[21])
    MemoWrite("Schreibanfragen gesendet ..................: " & $aInfo[22])
    MemoWrite("Schreibanfragen (groß) ....................: " & $aInfo[23])
    MemoWrite("Schreibanfragen (klein) ...................: " & $aInfo[24])
    MemoWrite("Verweigerte Raw-Lesevorgänge ..............: " & $aInfo[25])
    MemoWrite("Verweigerte Raw-Schreibvorgänge ...........: " & $aInfo[26])
    MemoWrite("Netzwerkfehler ............................: " & $aInfo[27])
    MemoWrite("Verbindungssitzungen eingerichtet .........: " & $aInfo[28])
    MemoWrite("Gescheiterte Sitzungen ....................: " & $aInfo[29])
    MemoWrite("Missglückte Verbindungen ..................: " & $aInfo[30])
    MemoWrite("PCNET Verbindungen ........................: " & $aInfo[31])
    MemoWrite("NetShare 20 Verbindungen ..................: " & $aInfo[32])
    MemoWrite("NetShare 21 Verbindungen ..................: " & $aInfo[33])
    MemoWrite("WinNT Verbindungen ........................: " & $aInfo[34])
    MemoWrite("Verbindungsabbrüche .......................: " & $aInfo[35])
    MemoWrite("Sitzungen abgelaufen ......................: " & $aInfo[36])
    MemoWrite("Verbindungen hergestellt ..................: " & $aInfo[37])
    MemoWrite("Verbindungen fehlgeschlagen ...............: " & $aInfo[38])
    MemoWrite("Unvollständige Anfragen ...................: " & $aInfo[39])

    ; 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