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 estes tipos de membros:

• Eventos
• Métodos
• Propriedades

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 de 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 o 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 as seguintes:

• Habilitar e desabilitar o sistema de cota de disco do volume.
• Obtendo o status do sistema de cotas no volume.
• Negar espaço em disco aos usuários excedendo o limite de cota.
• Especificando os valores padrão de limite de aviso e limite de cota que serão atribuídos a novos usuários.
• Adicionar e remover usuários.

O objeto DiskQuotaControl permite definir 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 de 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 no Microsoft Visual Basic.

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