UDF > NetShare >

_Net_Share_FileEnum

Obtient des informations sur les fichiers ouverts sur un serveur

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

Param�tres

$sServer [optionnel] Cha�ne qui contient le nom du serveur sur lequel la fonction s'ex�cutera.
Une cha�ne vide sp�cifie l'ordinateur local.
$sBaseName [optionnel] Cha�ne contenant un qualificatif pour les informations retourn�es.
Si vide toutes les ressources ouvertes sont �num�r�s.
Si non vide, la fonction �num�re uniquement les ressources qui ont $sBaseName comme pr�fixe.
$sUserName [optionnel] Cha�ne qui sp�cifie le nom de l'utilisateur.
Si non vide, $sUserName sert de qualificatif � l'�num�ration.

Valeur de retour

Succ�s: Retourne un tableau avec le format suivant:
    [0][0] - Nombre d'entr�es dans le tableau (n)
    [1][0] - Num�ro ID attribu� � la ressource lorsqu'elle est ouverte
    [1][1] - Autorisations d'acc�s associ�s � l'ouverture de l'application:
        1 - Autorisation d'acc�s pour lire une ressource et ex�cuter la ressource
        2 - Autorisation d'acc�s pour �crire dans une ressource.
        4 - Autorisation d'acc�s pour cr�er une ressource
        8 - Autorisation d'acc�s pour l'ex�cution
        16 - Autorisation d'acc�s pour la suppression
        32 - Autorisation d'acc�s pour modifier des attributs
        64 - Autorisation d'acc�s pour changer ACL
    [1][2] - Contient le nombre de verrous de fichier sur la ressource
    [1][3] - Indique le chemin de la ressource ouverte
    [1][4] - Sp�cifie l'utilisateur ou l'ordinateur qui a ouvert la ressource
�chec: D�finit @error <> 0.

Remarque

Seuls les membres Administrateurs ou du groupe local Server Operators peuvent ex�cuter cette fonction.

En relation

_Net_Share_ConnectionEnum, _Net_Share_SessionEnum, _Net_Share_ShareEnum

Voir aussi

Consultez NetFileEnum dans la librairie MSDN.

Exemple

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

Global $g_idMemo

Example()

Func Example()
    Local $sServer, $aInfo

    ; Cr�e une GUI
    GUICreate("NetShare", 400, 300)

    ; Cr�e un contr�le Memo
    $g_idMemo = GUICtrlCreateEdit("", 2, 2, 396, 296, $WS_VSCROLL)
    GUICtrlSetFont($g_idMemo, 9, 400, 0, "Courier New")
    GUISetState(@SW_SHOW)

    ; Obtient le serveur et le nom de partage
    $sServer = InputBox("NetWork Demo", "Tapez le nom du Serveur:", "\\MyServer", "", 200, 130)
    If @error Then Exit

    ; �num�re les fichiers ouverts sur le serveur
    $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

    ; Boucle jusqu'� ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example

; Ecrit un message dans le contr�le Memo
Func MemoWrite($sMessage = "")
    GUICtrlSetData($g_idMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite