DiskQuotaControl.TranslateLogonNameToSID-Methode

Übersetzt einen Anmeldenamen in die entsprechende Benutzersicherheits-ID im Zeichenfolgenformat.

Syntax

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

Parameter

Anmeldename

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 einschließenden geschweiften Klammern. Beispiel:

"{S-1-5-21-2127521184-1604012920-1887927527-19009}"

Hinweise

Die zurückgegebene SID-Zeichenfolge kann anstelle eines Anmeldenamens an die FindUser-Methode übergeben werden.

Wenn bei einem Aufruf der FindUser-Methode ( Anmeldename) ein Fehler auftritt, kann dies auf einen Konflikt zwischen dem Formular (z. B. SAM-kompatibel mit dem Sicherheitskonto-Manager [ und dem ] Benutzerprinzipalnamen-UPN) [ des ] angegebenen Anmeldenamens und dem im SID-Namencache 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 Cachesuche des SID-Namens. Dieses Verfahren wird im folgenden VbScript-Code (Microsoft Visual Basic Scripting Edition) veranschaulicht.

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 Name zu SID kann im Vergleich zu Suchfunktionen im SID-Namencache ein langsamer Prozess sein. Aus diesem Grund wird empfohlen, findUser zuerst mit einem Anmeldenamen aufzuweisen. Im obigen Beispiel wird diese Technik verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional, nur Windows [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
DLL
Shell32.dll (Version 5.0 oder höher)

Siehe auch

DiskQuotaControl-Objekt