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
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 |
|
Confira também