Méthode DiskQuotaControl.TranslateLogonNameToSID
Traduit un nom d’ouverture de session en l’ID de sécurité utilisateur correspondant au format chaîne.
Syntaxe
DiskQuotaControl.TranslateLogonNameToSID(
logonname
)
Paramètres
-
nom_connexion
-
Type : Chaîne
Valeur de chaîne qui spécifie le nom d’ouverture de session de l’utilisateur.
Valeur retournée
Retourne l’ID de sécurité utilisateur (SID) au format de chaîne correspondant au nom d’ouverture de session fourni. La chaîne retournée inclut les accolades englobantes standard. Exemple :
« {S-1-5-21-2127521184-1604012920-1887927527-19009} »
Notes
La chaîne SID retournée peut être passée à la méthode FindUser à la place d’un nom d’ouverture de session.
Lorsqu’un appel à la méthode FindUser( logonname) échoue, cela peut être dû à une incompatibilité entre le formulaire (par exemple, compatible avec le Gestionnaire de compte de sécurité [SAM] et le nom d’utilisateur principal [UPN]) du nom d’ouverture de session fourni et du formulaire stocké dans le cache siD-name. Dans ce cas, le nom d’ouverture de session peut être converti en SID et l’appel à FindUser répété. FindUser reconnaît une chaîne SID et contourne la recherche du cache siD-name. Le code Microsoft Visual Basic Scripting Edition (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
La traduction de nom en SID peut être un processus lent par rapport aux recherches dans le cache SID-name. Par conséquent, il est recommandé d’appeler FindUser d’abord avec un nom d’ouverture de session. L’exemple ci-dessus utilise cette technique.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| DLL |
|
Voir aussi