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

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.

 

Observaciones

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