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 |
|