Objeto DIDiskQuotaUser

Permite que um cliente gerencie as configurações de cota de disco global de um volume NTFS. Esse objeto disponibiliza a funcionalidade essencial da interface DIDiskQuotaUser para scripts e aplicativos baseados no Microsoft Visual Basic.

Membros

O objeto DIDiskQuotaUser tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

O objeto DIDiskQuotaUser tem esses métodos.

Propriedades

O objeto DIDiskQuotaUser tem essas propriedades.

Comentários

Cada usuário no volume gerenciado pelo objeto DiskQuotaControl tem um objeto DIDiskQuotaUser associado a ele. Esse objeto permite que um cliente gerencie as configurações de um usuário individual. Há várias maneiras de obter o objeto DIDiskQuotaUser de um usuário:

• Os objetos DIDiskQuotaUser para todos os usuários com cotas no volume são expostos como uma coleção e podem ser enumerados. Uma discussão sobre como enumerar objetos DIDiskQuotaUser é encontrada abaixo.
• Quando você adiciona um novo usuário, o método AddUser retorna o objeto DIDiskQuotaUser do usuário.
• Se você tiver o nome do usuário, o método FindUser retornará o objeto DIDiskQuotaUser do usuário.

Enumerando usuários de cota de disco

Os objetos DIDiskQuotaUser para todos os usuários com uma cota no volume são expostos como uma coleção. O objeto DiskQuotaControl exporta um método enumerador padrão que permite enumerar a coleção de objetos DIDiskQuotaUser . O procedimento a seguir ilustra como executar a enumeração com o Microsoft JScript (compatível com a especificação de linguagem ECMA 262). Você pode usar um procedimento semelhante com o Visual Basic ou o Microsoft Visual Basic Scripting Edition (VBScript).

1. Crie um novo objeto DiskQuotaControl .
2. Inicialize-o com Inicializar.
3. Crie um novo objeto Enumerador JScript.
4. Use um loop for para enumerar os objetos DIDiskQuotaUser . Não é necessário definir um valor inicial. O método moveNext do objeto enumerador notifica o método item para retornar o próximo objeto DIDiskQuotaUser . O método atEnd retorna false quando você chega ao final da lista.
5. Conforme necessário, use o objeto DIDiskQuotaUser retornado pelo método de item do enumerador para recuperar ou definir uma ou mais das propriedades de cota de disco do usuário associado.

O fragmento de código a seguir ilustra como enumerar objetos DIDiskQuotaUser com JScript. O argumento Volume_Label que é passado para a função EnumUsers é um valor de cadeia de caracteres que contém um rótulo de volume 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

Confira também

Objeto Shell