Metodo IDiskQuotaControl::AddUserName (dskquota.h)
Aggiunge una nuova voce di quota nel volume per l'utente specificato. L'utente viene identificato dal dominio e dal nome dell'account.
Sintassi
HRESULT AddUserName(
[in] LPCWSTR pszLogonName,
[in] DWORD fNameResolution,
[out] PDISKQUOTA_USER *ppUser
);
Parametri
[in] pszLogonName
Stringa del nome di accesso dell'account dell'utente.
[in] fNameResolution
Indica come ottenere le informazioni sull'account utente. Le informazioni sulla quota del volume identificano gli utenti in base al SID. Le informazioni sull'account utente, ad esempio il contenitore, il nome di accesso e il nome visualizzato, devono essere ottenute dal controller di dominio di rete o dal computer locale, se non si trova in una rete. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Risolvere le informazioni sull'account utente in modo asincrono. AddUserName restituisce immediatamente. Il chiamante deve implementare l'interfaccia IDiskQuotaEvents per ricevere una notifica quando le informazioni sono disponibili. Se le informazioni sono state memorizzate nella cache durante una richiesta precedente, la notifica viene eseguita non appena l'oggetto viene gestito. In caso contrario, il metodo ottiene le informazioni dal controller di dominio di rete, quindi notifica IDiskQuotaEvents. |
|
Non risolvere le informazioni sull'account utente. |
|
Risolvere le informazioni sull'account utente in modo sincrono. AddUserName restituisce quando le informazioni vengono risolte. Se le informazioni sono presenti nella cache SID della quota del disco, viene restituita immediatamente. In caso contrario, il metodo deve individuare le informazioni. Ciò può richiedere alcuni secondi. |
[out] ppUser
Puntatore al puntatore all'interfaccia IDiskQuotaUser all'oggetto utente quota appena creato.
Valore restituito
Questo metodo restituisce un errore del file system o uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
L'utente esiste già. Non aggiunto. |
|
L'oggetto DiskQuotaControl non viene inizializzato. |
|
Il nome utente specificato è sconosciuto. |
|
Un parametro del puntatore è NULL. |
|
Memoria insufficiente. |
|
Si è verificato un errore imprevisto del file system. |
|
Si è verificata un'eccezione imprevista. |
Commenti
Il file system NTFS crea automaticamente una voce di quota utente quando un utente scrive per la prima volta nel volume. Alle voci create automaticamente vengono assegnate le soglie di avviso predefinite e i valori limite di quota rigida per il volume. Questo metodo consente di creare una voce di quota utente prima che un utente abbia scritto informazioni nel volume. È quindi possibile preassegnare un valore soglia di avviso o limite di quota rigida diverso dalle impostazioni predefinite del volume.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | dskquota.h |
| DLL | Dskquota.dll |