Méthode DiskQuotaControl.FindUser

  • Article

Recherche l’entrée d’un utilisateur, par 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

Renvoie une expression d’objet qui est évaluée à l’objet DIDiskQuotaUser de l’utilisateur.

Notes

Cette méthode retourne un objet DIDiskQuotaUser même s’il n’existe aucune entrée pour l’utilisateur dans le fichier de quota. Le seuil d’avertissement et les limites de quota dur de l’objet utilisateur retournés sont définis 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 SID-name. Dans les cas où FindUser échoue en raison d’une incompatibilité dans le format (par exemple, compatible SAM et UPN) du nom de connexion fourni et du nom de connexion mis en cache, le nom de connexion peut être traduit en chaîne SID à l’aide de TranslateLogonNameToSID , puis passé à 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

Spécifications

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