Metodo IDiskQuotaControl::FindUserSid (dskquota.h)
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 |
|---|---|
|
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. |
|
Non risolvere le informazioni sull'account utente. |
|
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 |
|---|---|
|
Operazione completata. |
|
Il chiamante ha diritti di accesso insufficienti. |
|
L'oggetto DiskQuotaControl non viene inizializzato. |
|
Il SID per l'utente non è valido. |
|
Il parametro pUserSid o ppUser è NULL. |
|
Memoria insufficiente. |
|
Si è verificato un errore imprevisto del file system. |
|
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 |