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.

Método	Descrição
Invalidate	Limpa as informações de usuário armazenadas em cache do objeto.

 

Propriedades

O objeto DIDiskQuotaUser tem essas propriedades.

Propriedade	Tipo de acesso	Descrição
AccountContainerName	Somente leitura	Obtém o nome do contêiner de conta do usuário.
AccountStatus	Somente leitura	Obtém o status da conta do usuário.
DisplayName	Somente leitura	Obtém o nome de exibição do usuário.
ID	Somente leitura	Obtém uma ID que identifica exclusivamente o usuário.
LogonName	Somente leitura	Obtém o nome da conta de logon do usuário.
QuotaLimit	Leitura/gravação	Define ou obtém o limite de cota atual do usuário.
QuotaLimitText	Somente leitura	Obtém o limite de cota atual do usuário como uma cadeia de caracteres de texto.
QuotaThreshold	Leitura/gravação	Define ou obtém o limite de aviso do usuário, em bytes.
QuotaThresholdText	Somente leitura	Obtém o limite de aviso do usuário como uma cadeia de caracteres de texto.
QuotaUsed	Somente leitura	Obtém o uso atual do disco do usuário, em bytes.
QuotaUsedText	Somente leitura	Obtém o uso atual do disco do usuário como uma cadeia de caracteres de texto.

 

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

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

Objeto Shell