Функция _Net_Share_FileEnum

 ↑  ←  Описание функции

_Net_Share_FileEnum

Returns information about open files on a server

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

Параметры

$sServer [необязательный] String that contains the name of the server on which the function is to execute. A blank
    specifies the local computer.
$sBaseName [необязательный] String containing a qualifier for the returned information. If blank all open resources are
    enumerated. If not blank, the function enumerates only resources that have $sBaseName as a prefix.
$sUserName [необязательный] String that specifies the name of the user. If not blank $sUserName serves as a qualifier to
    the enumeration.

Возвращаемое значение

Успех:Возвращает массив следующего формата:
[0][0] - Number of entries in the array (n)
[1][0] - ID number assigned to the resource when it is opened
[1][1] - Access permissions associated with the opening application:
1 - Permission to read a resource and execute the resource
2 - Permission to write to a resource.
4 - Permission to create a resource
8 - Execute permission
16 - Delete permission
32 - Change attribute permission
64 - Change ACL permission
[1][2] - Contains the number of file locks on the resource
[1][3] - Specifies the path of the opened resource
[1][4] - Specifies which user or which computer opened the resource
Ошибка:Устанавливает @error

Примечания

Only members of the Administrators or Server Operators local group can execute this function

См. также

_Net_Share_ConnectionEnum, _Net_Share_SessionEnum, _Net_Share_ShareEnum

См. также

Искать NetFileEnum в библиотеке MSDN

Пример

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

Global $iMemo

_Main()

Func _Main()
    Local $hGUI, $sServer, $aInfo

    ; Создаёт GUI
    $hGUI = GUICreate("NetShare", 400, 300)

    ; Создаёт элемент для заметок
    $iMemo = GUICtrlCreateEdit("", 2, 2, 396, 296, $WS_VSCROLL)
    GUICtrlSetFont($iMemo, 9, 400, 0, "Courier New")
    GUISetState()

    ; Get server and share information
    $sServer = InputBox("NetWork Demo", "Enter Server Name:", "\\MyServer", "", 200, 130)
    If @error Then Exit

    ; Enumerate open files on the server
    $aInfo = _Net_Share_FileEnum ($sServer)
    MemoWrite("Error ...................: " & @error)
    MemoWrite("Entries read ............: " & $aInfo[0][0])
    For $iI = 1 To $aInfo[0][0]
        MemoWrite("Resource ID .............: " & $aInfo[$iI][0])
        MemoWrite("Resource permissions ....: " & _Net_Share_PermStr ($aInfo[$iI][1]))
        MemoWrite("Resource locks ..........: " & $aInfo[$iI][2])
        MemoWrite("Resource path ...........: " & $aInfo[$iI][3])
        MemoWrite("Resource user ...........: " & $aInfo[$iI][4])
        MemoWrite()
    Next

    ; Цикл выполняется, пока окно не будет закрыто
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>_Main

; Записывает строку в элемент для заметок
Func MemoWrite($sMessage = "")
    GUICtrlSetData($iMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite