Méthode DiskQuotaControl. FindUser

Recherche l’entrée d’un utilisateur, par son nom, dans le fichier de quota du volume.

Syntaxe

DiskQuotaControl.FindUser(
  sLogonName
)

Paramètres

sLogonName

Type : chaîne

Valeur de chaîne qui contient le nom d’ouverture de session de l’utilisateur.

Valeur retournée

Retourne une expression d’objet qui prend la valeur de l’objet DIDiskQuotaUser de l’utilisateur.

Remarques

Cette méthode retourne un objet DIDiskQuotaUser même s’il n’y a aucune entrée pour l’utilisateur dans le fichier de quota. Le seuil d’avertissement et les limites de quota matériel sont définis pour l’objet utilisateur retourné sur les valeurs par défaut du volume.

La chaîne retournée par TranslateLogonNameToSID peut être passée à la place du paramètre sLogonName . Quand FindUser reçoit une chaîne sid, il utilise le SID correspondant pour la recherche directe de l’enregistrement de quota de l’utilisateur sur le volume. Cela contourne le cache de noms SID. Dans les cas où FindUser échoue en raison d’une incompatibilité de format (par exemple, compatible Sam et UPN) du nom d’ouverture de session fourni et du nom d’ouverture de session mis en cache, le nom d’ouverture de session peut être traduit en une chaîne sid à l’aide de TranslateLogonNameToSID , puis retransmis à FindUser. Le code VBScript suivant illustre cette technique.

Function Find(dqc, name)
    On Error Resume Next
    SET Find = dqc.FindUser(name)

    If Err.Number <> 0 Then
        Err.Clear
        SET Find = dqc.FindUser(dqc.TranslateLogonNameToSID(name))
    End If    

End Function

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
DLL
Shell32.dll (version 5,0 ou ultérieure)

Voir aussi

Objet DiskQuotaControl