Freigeben über


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
Shell32.dll (Version 5.0 oder höher)

Siehe auch

DiskQuotaControl-Objekt