Méthode IDiskQuotaControl::FindUserName (dskquota.h)

  • Article

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
S_OK
 Réussite.
ERROR_ACCESS_DENIED
 L’appelant a des droits d’accès insuffisants.
ERROR_INVALID_SID
 Le SID de l’utilisateur n’est pas valide.
ERROR_NONE_MAPPED
 Aucun mappage n’est disponible pour le SID.
ERROR_NOT_READY
 L’objet DiskQuotaControl n’est pas initialisé.
E_INVALIDARG
 Le paramètre pUserSid ou ppUser est NULL.
E_OUTOFMEMORY
 Mémoire insuffisante.
E_FAIL
 Une erreur inattendue du système de fichiers s’est produite.
E_UNEXPECTED
 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

Voir aussi

Interfaces de gestion des disques

Quotas de disque

IDiskQuotaControl