DiskQuotaControl.FindUser-Methode

Artikel
06/13/2023

Sucht den Eintrag eines Benutzers anhand des Namens in der Kontingentdatei des Volumes.

Syntax

DiskQuotaControl.FindUser(
  sLogonName
)

Parameter

sLogonName

Typ: Zeichenfolge

Ein Zeichenfolgenwert, der den Anmeldenamen des Benutzers enthält.

Rückgabewert

Gibt einen Objektausdruck zurück, der zum DIDiskQuotaUser-Objekt des Benutzers ausgewertet wird.

Bemerkungen

Diese Methode gibt ein DIDiskQuotaUser-Objekt zurück, auch wenn in der Kontingentdatei kein Eintrag für den Benutzer vorhanden ist. Das zurückgegebene Benutzerobjekt verfügt über einen Warnschwellenwert und feste Kontingentgrenzwerte, die auf die Standardwerte des Volumes festgelegt sind.

Die von TranslateLogonNameToSID zurückgegebene Zeichenfolge kann anstelle des sLogonName-Parameters übergeben werden. Wenn FindUser eine SID-Zeichenfolge empfängt, wird die entsprechende SID für die direkte Suche des Kontingentdatensatzes des Benutzers auf dem Volume verwendet. Dadurch wird der SID-Name-Cache umgangen. In Fällen, in denen FindUser aufgrund eines Konflikts im Format (z. B. SAM-kompatibel und UPN) des angegebenen Anmeldenamens und des zwischengespeicherten Anmeldenamens fehlschlägt, kann der Anmeldename mithilfe von TranslateLogonNameToSID in eine SID-Zeichenfolge übersetzt und dann erneut an FindUser übergeben werden. Der folgende VBScript-Code 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

Anforderungen

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

Siehe auch

DiskQuotaControl-Objekt

Freigeben über