Metodo IDiskQuotaControl::FindUserName (dskquota.h)

Individua una voce specifica nelle informazioni sulla quota del volume. Il nome di accesso dell'account dell'utente viene usato come chiave di ricerca.

Sintassi

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

Parametri

[in] pszLogonName

Puntatore al nome di accesso dell'account dell'utente.

[out] ppUser

Puntatore al 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_INVALID_SID
Il SID per l'utente non è valido.
ERROR_NONE_MAPPED
Non è disponibile alcun mapping per il SID.
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

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 dell'aggiunta automatica degli utenti 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à una 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 disco

IDiskQuotaControl