Metodo IDiskQuotaControl::CreateEnumUsers (dskquota.h)

Articolo
03/05/2024

Crea un oggetto enumeratore per enumerare gli utenti delle quote nel volume. L'oggetto appena creato implementa l'interfaccia IEnumDiskQuotaUsers .

Sintassi

HRESULT CreateEnumUsers(
  [in]  PSID                  *rgpUserSids,
  [in]  DWORD                 cpSids,
  [in]  DWORD                 fNameResolution,
  [out] PENUM_DISKQUOTA_USERS *ppEnum
);

Parametri

[in] rgpUserSids

Matrice di puntatori SID (Security Identifier) che rappresentano gli oggetti utente da includere nell'enumerazione. Se questo valore è NULL, tutte le voci utente vengono enumerate.

[in] cpSids

Numero di elementi nella matrice rgpUserSids . Ignorato se rgpUserSids è NULL.

[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. Il metodo IEnumDiskQuotaUsers::Next 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. Il metodo IEnumDiskQuotaUsers::Next 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] ppEnum

Puntatore a un puntatore all'enumeratore IEnumDiskQuotaUsers .

Valore restituito

Questo metodo restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
ERROR_ACCESS_DENIED	Il chiamante ha diritti di accesso insufficienti.
ERROR_NOT_READY	L'oggetto DiskQuotaControl non viene inizializzato.
E_INVALIDARG	Il parametro ppEnum è NULL.
E_OUTOFMEMORY	Memoria insufficiente.
E_UNEXPECTED	Si è verificata un'eccezione imprevista.

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