DIDiskQuotaUser (objeto)

Permite a un cliente administrar la configuración de cuota de disco global de un volumen NTFS. Este objeto hace que la funcionalidad esencial de la interfaz DIDiskQuotaUser esté disponible para el scripting y las aplicaciones basadas en Microsoft Visual Basic.

Miembros

El objeto DIDiskQuotaUser tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

El objeto DIDiskQuotaUser tiene estos métodos.

Método	Descripción
Invalidate	Borra la información de usuario almacenada en caché del objeto.

 

Propiedades

El objeto DIDiskQuotaUser tiene estas propiedades.

Propiedad	Tipo de acceso	Descripción
AccountContainerName	Solo lectura	Obtiene el nombre del contenedor de cuentas del usuario.
AccountStatus	Solo lectura	Obtiene el estado de la cuenta del usuario.
DisplayName	Solo lectura	Obtiene el nombre para mostrar del usuario.
ID	Solo lectura	Obtiene un identificador que identifica de forma única al usuario.
LogonName	Solo lectura	Obtiene el nombre de la cuenta de inicio de sesión del usuario.
QuotaLimit	Lectura/escritura	Establece u obtiene el límite de cuota actual del usuario.
QuotaLimitText	Solo lectura	Obtiene el límite de cuota actual del usuario como una cadena de texto.
QuotaThreshold	Lectura/escritura	Establece u obtiene el umbral de advertencia del usuario, en bytes.
QuotaThresholdText	Solo lectura	Obtiene el umbral de advertencia del usuario como una cadena de texto.
QuotaUsed	Solo lectura	Obtiene el uso actual del disco del usuario, en bytes.
QuotaUsedText	Solo lectura	Obtiene el uso actual del disco del usuario como una cadena de texto.

 

Comentarios

Cada usuario del volumen administrado por el objeto DiskQuotaControl tiene asociado un objeto DIDiskQuotaUser . Este objeto permite a un cliente administrar la configuración de un usuario individual. Hay varias maneras de obtener el objeto DIDiskQuotaUser de un usuario:

• Los objetos DIDiskQuotaUser para todos los usuarios con cuotas en el volumen se exponen como una colección y se pueden enumerar. A continuación se describe cómo enumerar objetos DIDiskQuotaUser .
• Al agregar un nuevo usuario, el método AddUser devuelve el objeto DIDiskQuotaUser del usuario.
• Si tiene el nombre del usuario, el método FindUser devuelve el objeto DIDiskQuotaUser del usuario.

Enumeración de usuarios de cuota de disco

Los objetos DIDiskQuotaUser para todos los usuarios con una cuota en el volumen se exponen como una colección. El objeto DiskQuotaControl exporta un método enumerador estándar que permite enumerar la colección de objetos DIDiskQuotaUser . En el procedimiento siguiente se muestra cómo realizar la enumeración con Microsoft JScript (compatible con la especificación del lenguaje ECMA 262). Puede usar un procedimiento similar con Visual Basic o Microsoft Visual Basic Scripting Edition (VBScript).

1. Cree un nuevo objeto DiskQuotaControl .
2. Inicialícelo con Initialize.
3. Cree un nuevo objeto Enumerador de JScript.
4. Use un bucle for para enumerar los objetos DIDiskQuotaUser . No es necesario establecer un valor inicial. El método moveNext del objeto enumerador notifica al método item para devolver el siguiente objeto DIDiskQuotaUser . El método atEnd devuelve false cuando se llega al final de la lista.
5. Según sea necesario, use el objeto DIDiskQuotaUser devuelto por el método item del enumerador para recuperar o establecer una o varias de las propiedades de cuota de disco del usuario asociado.

En el fragmento de código siguiente se muestra cómo enumerar objetos DIDiskQuotaUser con JScript. El argumento Volume_Label que se pasa a la función EnumUsers es un valor de cadena que contiene una etiqueta de volumen como "C:\\".

function EnumUsers(Volume_Label)
{
    var Volume;
    var QuotaUsers;
    var QuotaUser;

    Volume = new ActiveXObject("Microsoft.DiskQuota.1");
    Volume.Initialize(Volume_Label, 1);

    QuotaUsers = new Enumerator(Volume);
    for (;!Users.atEnd(); Users.moveNext())
    {
       QuotaUser = QuotaUsers.item();

     //Use the QuotaUser object to retrieve or set one or more
     //of the user's disk quota properties
     ...
    }
}

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

Shell (objeto)