Método DiskQuotaControl.FindUser

Busca la entrada de un usuario, por nombre, en el archivo de cuota del volumen.

Sintaxis

DiskQuotaControl.FindUser(
  sLogonName
)

Parámetros

sLogonName

Tipo: Cadena

Valor de cadena que contiene el nombre de inicio de sesión del usuario.

Valor devuelto

Devuelve una expresión de objeto que se evalúa como el objeto DIDiskQuotaUser del usuario.

Comentarios

Este método devuelve un objeto DIDiskQuotaUser aunque no haya ninguna entrada para el usuario en el archivo de cuota. El objeto de usuario devuelto tiene un umbral de advertencia y límites de cuota estrictos establecidos en los valores predeterminados del volumen.

La cadena devuelta desde TranslateLogonNameToSID se puede pasar en lugar del parámetro sLogonName . Cuando FindUser recibe una cadena de SID, usa el SID correspondiente para la búsqueda directa del registro de cuota del usuario en el volumen. Esto omite la caché de nombres de SID. En los casos en los que FindUser produce un error debido a un error de coincidencia en el formato (por ejemplo, compatible con SAM y UPN) del nombre de inicio de sesión proporcionado y el nombre de inicio de sesión almacenado en caché, el nombre de inicio de sesión se puede traducir a una cadena SID mediante TranslateLogonNameToSID y, a continuación, se pasa de nuevo a FindUser. El código VBScript siguiente ilustra esta técnica.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

DiskQuotaControl (objeto)