Objeto DiskQuotaControl

Permite que um administrador gerencie as propriedades de cota de disco de um volume. O sistema de arquivos NTFS permite que um administrador gerencie o uso do disco em um volume compartilhado alocando uma quantidade especificada de espaço em disco, ou limite de cota, para cada usuário. Você pode usar esse objeto para definir o limite de cota padrão que será atribuído automaticamente a todos os novos usuários.

Membros

O objeto DiskQuotaControl tem esses tipos de membros:

Eventos

O objeto DiskQuotaControl tem esses eventos.

Evento Descrição
OnUserNameChanged Ocorre quando as informações de nome de um objeto DIDiskQuotaUser foram resolvidas .

 

Métodos

O objeto DiskQuotaControl tem esses métodos.

Método Descrição
Adduser Atribui uma cota de disco não padrão a um novo usuário.
DeleteUser Exclui um usuário do volume.
FindUser Localiza a entrada de um usuário, por nome, no arquivo de cota do volume.
GiveUserNameResolutionPriority Coloca o objeto de usuário especificado em seguida na linha para resolução de nomes.
Inicializar Abre um volume especificado e inicializa seu objeto de controle de cota.
InvalidateSidNameCache Invalida o cache de nome de usuário da ID de segurança.
ShutdownNameResolution Desliga o thread de resolução de nome de usuário.
TranslateLogonNameToSID Converte um nome de logon para a ID de segurança do usuário correspondente no formato de cadeia de caracteres.

 

Propriedades

O objeto DiskQuotaControl tem essas propriedades.

Propriedade Tipo de acesso Descrição
DefaultQuotaLimit
Leitura/gravação
Define ou obtém o limite de cota padrão.
DefaultQuotaLimitText
Somente leitura
Obtém o limite de cota padrão como uma cadeia de caracteres de texto.
DefaultQuotaThreshold
Leitura/gravação
Define ou obtém o limite de cota padrão.
DefaultQuotaThresholdText
Somente leitura
Obtém o limite de cota padrão como uma cadeia de caracteres de texto.
LogQuotaLimit
Leitura/gravação
Define ou obtém um valor booliano que indica se uma entrada de log de eventos do sistema será feita quando um usuário exceder seu limite de cota atribuído.
LogQuotaThreshold
Leitura/gravação
Define ou obtém um valor booliano que indica se uma entrada de log de eventos do sistema será feita quando um usuário exceder o limite de cota atribuído.
QuotaFileIncomplete
Somente leitura
Obtém um valor booliano que indica se o arquivo de cota do volume está concluído.
QuotaFileRebuilding
Somente leitura
Obtém um valor booliano que indica se o arquivo de cota do volume está sendo recriado no momento.
QuotaState
Leitura/gravação
Define ou obtém o estado das cotas de disco do volume.
UserNameResolution
Leitura/gravação
Define ou obtém um valor que controla como o SID do usuário é resolvido para nomes de usuário.

 

Comentários

Um administrador pode usar o objeto DiskQuotaControl para realizar várias tarefas, incluindo o seguinte:

  • Habilitando e desabilitando o sistema de cota de disco do volume.
  • Obtendo o status do sistema de cotas no volume.
  • Negando espaço em disco a usuários que excedem seu limite de cota.
  • Especificando o limite de aviso padrão e os valores de limite de cota que serão atribuídos a novos usuários.
  • Adicionando e removendo usuários.

O objeto DiskQuotaControl permite que você defina valores padrão globais para o volume para propriedades como limites de cota. No entanto, cada usuário é representado por um objeto DIDiskQuotaUser que pode ser usado para especificar configurações de cota individuais.

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. Para obter uma discussão sobre como enumerar objetos DIDiskQuotaUser , consulte Enumerando usuários de cota de disco na seção Comentários do DIDiskQuotaUser.
  • 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.

Esse objeto disponibiliza a funcionalidade essencial da interface IDiskQuotaControl para scripts e aplicativos baseados em Visual Basic da Microsoft.

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