Objeto DIDiskQuotaUser

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

Membros

O objeto DIDiskQuotaUser tem esses tipos de membros:

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 Initialize.
  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 de 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