Share via


Metodo DiskQuotaControl.FindUser

Trova la voce di un utente, in base al nome, nel file di quota del volume.

Sintassi

DiskQuotaControl.FindUser(
  sLogonName
)

Parametri

sLogonName

Tipo: String

Valore stringa contenente il nome di accesso dell'utente.

Valore restituito

Restituisce un'espressione di oggetto che restituisce l'oggetto DIDiskQuotaUser dell'utente.

Commenti

Questo metodo restituisce un oggetto DIDiskQuotaUser anche se non è presente alcuna voce per l'utente nel file di quota. L'oggetto utente restituito ha soglia di avviso e limiti di quota rigidi impostati sui valori predefiniti del volume.

La stringa restituita da TranslateLogonNameToSID può essere passata al posto del parametro sLogonName . Quando FindUser riceve una stringa SID, usa il SID corrispondente per la ricerca diretta del record di quota dell'utente nel volume. In questo modo viene ignorata la cache dei nomi SID. Nei casi in cui FindUser non riesce a causa di una mancata corrispondenza in formato (ad esempio, SAM-compatibile e UPN) del nome di accesso specificato e del nome di accesso memorizzato nella cache, il nome di accesso può essere convertito in una stringa SID usando TranslateLogonNameToSID e quindi passato di nuovo a FindUser. Il codice VBScript seguente illustra questa tecnica.

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

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
DLL
Shell32.dll (versione 5.0 o successiva)

Vedi anche

Oggetto DiskQuotaControl