Metodo IDiskQuotaControl::FindUserSid (dskquota.h)

Articolo
08/23/2023

Individua una voce utente specifica nelle informazioni sulla quota del volume. L'identificatore di sicurezza dell'utente viene usato come chiave di ricerca.

Sintassi

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

Parametri

[in] pUserSid

Puntatore al 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. FindUserSid 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. FindUserSid restituisce quando le informazioni sono state 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 per ricevere il puntatore dell'interfaccia IDiskQuotaUser all'oggetto utente quota.

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_NOT_READY	L'oggetto DiskQuotaControl non viene inizializzato.
ERROR_INVALID_SID	Il SID per l'utente non è valido.
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

Questo metodo restituirà un oggetto utente anche se non è presente alcun record di quota per l'utente nel file di quota. Ciò è coerente con l'idea di aggiunta automatica dell'utente e delle impostazioni di quota predefinite. Se attualmente non è presente alcuna voce di quota per l'utente richiesto e l'utente verrà aggiunto al file di quota se dovesse richiedere spazio su disco, l'oggetto utente restituito avrà soglia di avviso e limiti di quota rigidi uguali alle 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

Vedi anche

Interfacce di gestione dei dischi

Quote del disco

IDiskQuotaControl

Condividi tramite