_Net_Share_SessionGetInfo

Beschreibung anzeigen in

Liefert Informationen über eine zwischen einem Server und Workstation aufgebaute Verbindung (Session)

#include <NetShare.au3>
_Net_Share_SessionGetInfo ( $sServer, $sClientName, $sUserName )

Parameter

$sServer	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	Gibt den Namen der Computer-Session an, für die Informationen erhalten werden soll. Dieser Parameter darf nicht weggelassen werden .
$sUserName	String, der den Namen des Benutzers angibt, von dem Session-Informationen erhalten werden soll. Dieser Parameter darf nicht weggelassen werden .

Rückgabewert

Erfolg:

Ein Array mit dem folgenden Format:
    [0] - Name des Computers, der die Session aufgebaut hat
    [1] - Name des Users, der die Session aufgebaut hat
    [2] - Anzahl der Dateien, Geräte und Pipes, die während der Session geöffnet wurden
    [3] - Anzahl der Sekunden, die die Session aktiv war
    [4] - Anzahl der Sekunden, die die Session im Leerlauf war
    [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
    [6] - Bestimmt den Client-Typ, der die Session aufgebaut hat

Fehler:

Setzt das @error Flag auf ungleich null.

Bemerkungen

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

Siehe auch

Suche nach NetSessionGetInfo in der MSDN Bibliothek.

Beispiel

#include <GuiConstantsEx.au3>
#include <NetShare.au3>
#include <WindowsConstants.au3>

Global $g_idMemo

Example()

Func Example()
    Local $sServer, $aInfo

    ; Erstellt eine GUI
    GUICreate("NetShare", 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)

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

    ; Ermittelt die Sitzungs-Informationen
    $aInfo = _Net_Share_SessionGetInfo($sServer, @ComputerName, "Administrator")
    MemoWrite("Fehler ..........: " & @error)
    MemoWrite("Computername ..: " & $aInfo[0])
    MemoWrite("Benutzername ......: " & $aInfo[1])
    MemoWrite("Geöffnete Ressourcen .: " & $aInfo[2])
    MemoWrite("Aktive Zeit .: " & $aInfo[3])
    MemoWrite("Inaktive Zeit ...: " & $aInfo[4])
    MemoWrite("Art der Verbindung : " & $aInfo[5])
    MemoWrite("Art des Endgerätes ....: " & $aInfo[6])

    ; 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