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

  • Article

Recherche une entrée utilisateur spécifique dans les informations de quota de volume. L’identificateur de sécurité (SID) de l’utilisateur est utilisé comme clé de recherche.

Syntaxe

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

Paramètres

[in] pUserSid

Pointeur vers le SID de l’utilisateur.

[in] fNameResolution

Indique comment obtenir les informations du compte d’utilisateur. Les informations de quota du volume identifient les utilisateurs par SID. Les informations du compte d’utilisateur (telles que le nom de domaine, le nom du compte et le nom complet) doivent être obtenues auprès du contrôleur de domaine réseau ou de l’ordinateur local s’il ne se trouve pas sur un réseau. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
DISKQUOTA_USERNAME_RESOLVE_ASYNC
2
 Résolvez les informations de compte d’utilisateur de manière asynchrone. FindUserSid retourne immédiatement. L’appelant doit implémenter l’interface IDiskQuotaEvents pour recevoir une notification lorsque les informations sont disponibles. Si les informations ont été mises en cache lors d’une demande précédente, une notification se produit dès que l’objet est mis en service. Sinon, la méthode obtient les informations du contrôleur de domaine réseau, puis notifie IDiskQuotaEvents.
DISKQUOTA_USERNAME_RESOLVE_NONE
0
 Ne résolvez pas les informations de compte d’utilisateur.
DISKQUOTA_USERNAME_RESOLVE_SYNC
1
 Résoudre les informations de compte d’utilisateur de manière synchrone. FindUserSid retourne une fois que les informations ont été résolues. Si les informations existent dans le cache SID du quota de disque, elles sont retournées immédiatement. Sinon, la méthode doit localiser les informations. Le démarrage peut prendre plusieurs secondes.

[out] ppUser

Pointeur pour recevoir le pointeur d’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_NOT_READY
 L’objet DiskQuotaControl n’est pas initialisé.
ERROR_INVALID_SID
 Le SID de l’utilisateur n’est pas valide.
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