Oggetto DiskQuotaControl

Consente a un amministratore di gestire le proprietà della quota del disco di un volume. Il file system NTFS consente a un amministratore di gestire l'utilizzo del disco in un volume condiviso allocando una quantità specificata di spazio su disco, o limite di quota, a ogni utente. È possibile utilizzare questo oggetto per impostare il limite di quota predefinito che verrà assegnato automaticamente a tutti i nuovi utenti.

Membri

L'oggetto DiskQuotaControl ha questi tipi di membri:

Eventi

L'oggetto DiskQuotaControl include questi eventi.

Event Descrizione
OnUserNameChanged Si verifica quando le informazioni sul nome per un oggetto DIDiskQuotaUser sono state risolte.

 

Metodi

L'oggetto DiskQuotaControl dispone di questi metodi.

Metodo Descrizione
Adduser Assegna una quota disco non predefinita a un nuovo utente.
DeleteUser Elimina un utente dal volume.
FindUser Trova la voce di un utente, in base al nome, nel file di quota del volume.
GiveUserNameResolutionPriority Inserisce l'oggetto utente specificato accanto nella riga per la risoluzione dei nomi.
Initialize Apre un volume specificato e ne inizializza l'oggetto controllo quota.
InvalidateSidNameCache Invalida la cache del nome utente dell'ID di sicurezza.
ShutdownNameResolution Arresta il thread di risoluzione dei nomi utente.
TranslateLogonNameToSID Converte un nome di accesso nell'ID di sicurezza utente corrispondente in formato stringa.

 

Proprietà

L'oggetto DiskQuotaControl ha queste proprietà.

Proprietà Tipo di accesso Descrizione
DefaultQuotaLimit
Lettura/Scrittura
Imposta o ottiene il limite di quota predefinito.
DefaultQuotaLimitText
Sola lettura
Ottiene il limite di quota predefinito come stringa di testo.
DefaultQuotaThreshold
Lettura/Scrittura
Imposta o ottiene la soglia di quota predefinita.
DefaultQuotaThresholdText
Sola lettura
Ottiene la soglia di quota predefinita come stringa di testo.
LogQuotaLimit
Lettura/Scrittura
Imposta o ottiene un valore booleano che indica se verrà effettuata una voce del registro eventi di sistema quando un utente supera il limite di quota assegnato.
LogQuotaThreshold
Lettura/Scrittura
Imposta o ottiene un valore booleano che indica se verrà eseguita una voce del registro eventi di sistema quando un utente supera la soglia di quota assegnata.
QuotaFileIncomplete
Sola lettura
Ottiene un valore booleano che indica se il file di quota per il volume è completo.
QuotaFileRebuilding
Sola lettura
Ottiene un valore booleano che indica se il file di quota per il volume è in fase di ricompilazione.
QuotaState
Lettura/Scrittura
Imposta o ottiene lo stato delle quote del disco del volume.
UserNameResolution
Lettura/Scrittura
Imposta o ottiene un valore che controlla la modalità di risoluzione del SID utente nei nomi utente.

 

Commenti

Un amministratore può utilizzare l'oggetto DiskQuotaControl per eseguire una serie di attività, tra cui le operazioni seguenti:

  • Abilitazione e disabilitazione del sistema di quota disco del volume.
  • Ottenere lo stato del sistema di quota nel volume.
  • Negazione dello spazio su disco agli utenti che superano il limite di quota.
  • Specifica dei valori di soglia di avviso e limite di quota predefiniti che verranno assegnati ai nuovi utenti.
  • Aggiunta e rimozione di utenti.

L'oggetto DiskQuotaControl consente di impostare i valori predefiniti globali per il volume per le proprietà, ad esempio i limiti di quota. Tuttavia, ogni utente è rappresentato da un oggetto DIDiskQuotaUser che può essere usato per specificare singole impostazioni di quota.

Esistono diversi modi per ottenere l'oggetto DIDiskQuotaUser di un utente:

  • Gli oggetti DIDiskQuotaUser per tutti gli utenti con quote nel volume vengono esposti come raccolta e possono essere enumerati. Per informazioni su come enumerare gli oggetti DIDiskQuotaUser , vedere Enumerating Disk Quota Users nella sezione Osservazioni di DIDiskQuotaUser.
  • Quando si aggiunge un nuovo utente, il metodo AddUser restituisce l'oggetto DIDiskQuotaUser dell'utente.
  • Se si ha il nome dell'utente, il metodo FindUser restituisce l'oggetto DIDiskQuotaUser dell'utente.

Questo oggetto rende disponibile la funzionalità essenziale dell'interfaccia IDiskQuotaControl per la creazione di script e le applicazioni basate su Microsoft Visual Basic.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
DLL
Shell32.dll (versione 5.0 o successiva)

Vedi anche

Oggetto Shell