Méthode IDiskQuotaControl::FindUserName (dskquota.h)
Recherche une entrée spécifique dans les informations de quota de volume. Le nom de connexion au compte de l’utilisateur est utilisé comme clé de recherche.
Syntaxe
HRESULT FindUserName(
[in] LPCWSTR pszLogonName,
[out] PDISKQUOTA_USER *ppUser
);
Paramètres
[in] pszLogonName
Pointeur vers le nom d’ouverture de session du compte de l’utilisateur.
[out] ppUser
Pointeur vers le pointeur de l’interface IDiskQuotaUser vers l’objet utilisateur de quota.
Valeur retournée
Cette méthode retourne une erreur de système de fichiers ou l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
Réussite. |
|
L’appelant a des droits d’accès insuffisants. |
|
Le SID de l’utilisateur n’est pas valide. |
|
Aucun mappage n’est disponible pour le SID. |
|
L’objet DiskQuotaControl n’est pas initialisé. |
|
Le paramètre pUserSid ou ppUser est NULL. |
|
Mémoire insuffisante. |
|
Une erreur inattendue du système de fichiers s’est produite. |
|
Une exception inattendue s’est produite. |
Notes
Cette méthode retourne un objet utilisateur même s’il n’existe aucun enregistrement de quota pour l’utilisateur dans le fichier de quota. Cela est cohérent avec l’idée d’ajout automatique d’utilisateurs et de paramètres de quota par défaut. S’il n’existe actuellement aucune entrée de quota pour l’utilisateur demandé et que l’utilisateur est ajouté au fichier de quota s’il devait demander de l’espace disque, l’objet utilisateur retourné aura un seuil d’avertissement et des limites de quota dur égales aux paramètres par défaut du volume.
Spécifications
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | dskquota.h |
| DLL | Dskquota.dll |