_Net_Share_SessionEnum

Beschreibung anzeigen in

Liefert Informationen über die zu einem Server aufgebauten Verbindungen (Sessions)

#include <NetShare.au3>
_Net_Share_SessionEnum ( [$sServer = "" [, $sClientName = "" [, $sUserName = ""]]] )

Parameter

$sServer	[optional] String, der den DNS- oder NetBIOS-Namen des Remote Servers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter leer bleibt, wird der lokale Computer verwendet.
$sClientName	[optional] Gibt den Namen der Computer-Session an, für die Informationen erhalten werden soll. Wenn dieser Parameter leer bleibt, gibt die Funktion Informationen über alle Computer-Sessions auf dem Server zurück.
$sUserName	[optional] Gibt den Namen des Benutzers an, von dem Informationen erhalten werden soll. Wenn dieser Parameter leer bleibt, gibt die Funktion Informationen über alle Benutzer zurück.

Rückgabewert

Erfolg:

Ein Array mit dem folgenden Format
    [0][0] - Anzahl der Array-Einträge
    [1][0] - Name des Computers, der die Session aufgebaut hat
    [1][1] - Name des Users, der die Session aufgebaut hat
    [1][2] - Anzahl der Dateien, Geräte und Pipes, die während der Session geöffnet wurden
    [1][3] - Anzahl der Sekunden, die die Session aktiv war
    [1][4] - Anzahl der Sekunden, die die Session im Leerlauf war
    [1][5] - Bestimmt, wie der Benutzer die Session aufgebaut hat:
     1 - Benutzer baute die Session über einen Gast-Account auf
        2 - Benutzer baute die Session auf, ohne Passwort-Verschlüsselung zu benutzen
    [1][6] - Bestimmt den Client-Typ, der die Session aufgebaut hat
    [1][7] - Name des Transports, den der Client benutzt

Fehler:

Setzt das @error Flag auf ungleich 0.

Bemerkungen

Nur Mitglieder der lokalen Gruppen Administratoren oder Server Operatoren können diese Funktion ausführen.

Siehe auch

Suche nach NetSessionEnum in der MSDN Bibliothek.

Beispiel

#include "Extras\HelpFileInternals.au3"

#include <GUIConstantsEx.au3>
#include <NetShare.au3>
#include <WindowsStylesConstants.au3>

Example()

Func Example()
    Local $sServer, $aInfo

    ; Erstellt eine GUI
    GUICreate("NetShare", 400, 300)

    ; Erstellt ein Memo Control
    _MemoCreate(2, 2, 396, 296, $WS_VSCROLL)
    GUISetState(@SW_SHOW)

    ; Ermittelt die Server- und die Freigabe-Informationen
    $sServer = InputBox("NetWork Demo", "Eingabe des Server-Namens:", "\\MyServer", "", 200, 130)
    If @error Then Exit

    ; Listet die Netzwerk-Sitzungen auf
    $aInfo = _Net_Share_SessionEnum($sServer, @ComputerName)
    _MemoWrite("Fehler ..........: " & @error)
    _MemoWrite("Gelesene Einträge ...: " & $aInfo[0][0])
    For $iI = 1 To $aInfo[0][0]
        _MemoWrite("Computernamen ..: " & $aInfo[$iI][0])
        _MemoWrite("Benutzernamen.......: " & $aInfo[$iI][1])
        _MemoWrite("Geöffnete Ressourcen .: " & $aInfo[$iI][2])
        _MemoWrite("Aktive Zeit .: " & $aInfo[$iI][3])
        _MemoWrite("Inaktive Zeit ...: " & $aInfo[$iI][4])
        _MemoWrite("Art der Verbindung : " & $aInfo[$iI][5])
        _MemoWrite("Art des Endgerätes ....: " & $aInfo[$iI][6]) ???
        _MemoWrite("Übertragene Daten ......: " & $aInfo[$iI][7]) ???
        _MemoWrite()
    Next

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example