Oggetto DIDiskQuotaUser

Consente a un client di gestire le impostazioni di quota del disco globale di un volume NTFS. Questo oggetto rende disponibile la funzionalità essenziale dell'interfaccia DIDiskQuotaUser per gli script e le applicazioni basate su Microsoft Visual Basic.

Membri

L'oggetto DIDiskQuotaUser ha questi tipi di membri:

• Metodi
• Proprietà

Metodi

L'oggetto DIDiskQuotaUser dispone di questi metodi.

Metodo	Descrizione
Invalidate	Cancella le informazioni utente memorizzate nella cache dell'oggetto.

 

Proprietà

L'oggetto DIDiskQuotaUser ha queste proprietà.

Proprietà	Tipo di accesso	Descrizione
AccountContainerName	Sola lettura	Ottiene il nome del contenitore dell'account dell'utente.
AccountStatus	Sola lettura	Ottiene lo stato dell'account dell'utente.
DisplayName	Sola lettura	Ottiene il nome visualizzato dell'utente.
ID	Sola lettura	Ottiene un ID che identifica in modo univoco l'utente.
LogonName	Sola lettura	Ottiene il nome dell'account di accesso dell'utente.
QuotaLimit	Lettura/Scrittura	Imposta o ottiene il limite di quota corrente dell'utente.
QuotaLimitText	Sola lettura	Ottiene il limite di quota corrente dell'utente come stringa di testo.
QuotaThreshold	Lettura/Scrittura	Imposta o ottiene la soglia di avviso dell'utente, espressa in byte.
QuotaThresholdText	Sola lettura	Ottiene la soglia di avviso dell'utente come stringa di testo.
QuotaUsed	Sola lettura	Ottiene l'utilizzo corrente del disco dell'utente, espresso in byte.
QuotaUsedText	Sola lettura	Ottiene l'utilizzo corrente del disco dell'utente come stringa di testo.

 

Commenti

A ogni utente del volume gestito dall'oggetto DiskQuotaControl è associato un oggetto DIDiskQuotaUser . Questo oggetto consente a un client di gestire le impostazioni di un singolo utente. 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. Di seguito è riportata una descrizione dell'enumerazione degli oggetti 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.

Enumerazione degli utenti della quota del disco

Gli oggetti DIDiskQuotaUser per tutti gli utenti con una quota nel volume vengono esposti come raccolta. L'oggetto DiskQuotaControl esporta un metodo enumeratore standard che consente di enumerare la raccolta di oggetti DIDiskQuotaUser . La procedura seguente illustra come eseguire l'enumerazione con Microsoft JScript (compatibile con la specifica del linguaggio ECMA 262). È possibile utilizzare una procedura simile con Visual Basic o Microsoft Visual Basic Scripting Edition (VBScript).

1. Creare un nuovo oggetto DiskQuotaControl .
2. Inizializzarlo con Initialize.
3. Creare un nuovo oggetto Enumeratore JScript.
4. Utilizzare un ciclo for per enumerare gli oggetti DIDiskQuotaUser . Non è necessario impostare un valore iniziale. Il metodo moveNext dell'oggetto enumeratore notifica al metodo item di restituire l'oggetto DIDiskQuotaUser successivo. Il metodo atEnd restituisce false quando si raggiunge la fine dell'elenco.
5. Se necessario, utilizzare l'oggetto DIDiskQuotaUser restituito dal metodo item dell'enumeratore per recuperare o impostare una o più proprietà della quota del disco dell'utente associato.

Il frammento di codice seguente illustra come enumerare gli oggetti DIDiskQuotaUser con JScript. L'argomento Volume_Label passato alla funzione EnumUsers è un valore stringa contenente un'etichetta del volume, ad esempio "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
     ...
    }
}

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