_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