DiskQuotaControl.TranslateLogonNameToSID-Methode
Übersetzt einen Anmeldenamen in die entsprechende Benutzersicherheits-ID im Zeichenfolgenformat.
Syntax
DiskQuotaControl.TranslateLogonNameToSID(
logonname
)
Parameter
-
Logonname
-
Typ: Zeichenfolge
Ein Zeichenfolgenwert, der den Anmeldenamen des Benutzers angibt.
Rückgabewert
Gibt die Benutzersicherheits-ID (SID) im Zeichenfolgenformat zurück, das dem angegebenen Anmeldenamen entspricht. Die zurückgegebene Zeichenfolge enthält die standardmäßig eingeschlossenen geschweiften Klammern. Beispiel:
"{S-1-5-21-2127521184-1604012920-1887927527-19009}"
Bemerkungen
Die zurückgegebene SID-Zeichenfolge kann anstelle eines Anmeldenamens an die FindUser-Methode übergeben werden.
Wenn bei einem Aufruf der FindUser( logonname)-Methode ein Fehler auftritt, kann dies auf einen Konflikt zwischen dem Formular (z. B. dem Sicherheitskonto-Manager [SAM] und dem Benutzerprinzipalnamen [UPN]) des angegebenen Anmeldenamens und dem im SID-Namenscache gespeicherten Formular zurückzuführen sein. In solchen Fällen kann der Anmeldename in eine SID konvertiert und der Aufruf von FindUser wiederholt werden. FindUser erkennt eine SID-Zeichenfolge und umgeht die Sid-Name-Cachesuche. Der folgende VbScript-Code (Microsoft Visual Basic Scripting Edition) veranschaulicht dieses Verfahren.
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
Die Übersetzung von Namen zu SID kann im Vergleich zu Nachschlagevorgängen im SID-Name-Cache langsam sein. Daher wird empfohlen, FindUser zuerst mit einem Anmeldenamen zu aufrufen. Im obigen Beispiel wird diese Technik verwendet.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
DLL |
|
Siehe auch