Metodo IDiskQuotaControl::AddUserSid (dskquota.h)

Articolo
08/23/2023

Aggiunge una nuova voce di quota nel volume per l'utente specificato. L'utente viene identificato dall'identificatore di sicurezza (SID).

Sintassi

HRESULT AddUserSid(
  [in]  PSID            pUserSid,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Parametri

[in] pUserSid

SID dell'utente.

[in] fNameResolution

Indica come ottenere le informazioni sull'account utente. Le informazioni sulla quota del volume identificano gli utenti tramite SID. Le informazioni sull'account utente ,ad esempio nome di dominio, nome account e nome completo, 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
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	Risolvere le informazioni sull'account utente in modo asincrono. AddUserSid restituisce immediatamente. Il chiamante deve implementare l'interfaccia IDiskQuotaEvents per ricevere una notifica quando sono disponibili le informazioni. Se le informazioni sono state memorizzate nella cache durante una richiesta precedente, la notifica si verifica non appena l'oggetto viene eseguito il servizio. In caso contrario, il metodo ottiene le informazioni dal controller di dominio di rete, quindi notifica IDiskQuotaEvents.
DISKQUOTA_USERNAME_RESOLVE_NONE 0	Non risolvere le informazioni sull'account utente.
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	Risolvere le informazioni sull'account utente in modo sincrono. AddUserSid 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
S_OK	Operazione completata.
ERROR_ACCESS_DENIED	Il chiamante ha diritti di accesso insufficienti.
ERROR_INVALID_SID	L'SDI specificato è sconosciuto.
ERROR_NOT_READY	L'oggetto DiskQuotaControl non viene inizializzato.
E_INVALIDARG	Il parametro pUserSid o ppUser è NULL.
E_OUTOFMEMORY	Memoria insufficiente.
E_FAIL	Si è verificato un errore imprevisto del file system.
E_UNEXPECTED	Si è verificata un'eccezione imprevista.

Commenti

Il file system NTFS crea automaticamente una voce di quota utente quando un utente scrive prima nel volume. Le voci create automaticamente vengono assegnate alla soglia di avviso predefinita e ai valori limite di quota hard per il volume. Questo metodo consente di creare una voce di quota utente prima che un utente abbia scritto informazioni nel volume. È pertanto possibile assegnare una soglia di avviso o un valore limite di quota rigido diverso dalle impostazioni predefinite del volume.

Requisiti

Requisito	Valore
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

Vedi anche

Interfacce di gestione dei dischi

Quote del disco

IDiskQuotaControl

Condividi tramite