IDiskQuotaControl ::CreateEnumUsers, méthode (dskquota.h)

Article
02/28/2024

Crée un objet énumérateur pour énumérer les utilisateurs de quota sur le volume. L’objet nouvellement créé implémente l’interface IEnumDiskQuotaUsers .

Syntaxe

HRESULT CreateEnumUsers(
  [in]  PSID                  *rgpUserSids,
  [in]  DWORD                 cpSids,
  [in]  DWORD                 fNameResolution,
  [out] PENUM_DISKQUOTA_USERS *ppEnum
);

Paramètres

[in] rgpUserSids

Tableau de pointeurs d’identificateur de sécurité (SID) représentant les objets utilisateur à inclure dans l’énumération. Si cette valeur est NULL, toutes les entrées utilisateur sont énumérées.

[in] cpSids

Nombre d’éléments dans le tableau rgpUserSids . Ignoré si rgpUserSids a la valeur NULL.

[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. La méthode IEnumDiskQuotaUsers ::Next 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. La méthode IEnumDiskQuotaUsers ::Next retourne lorsque les informations sont 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] ppEnum

Pointeur vers un pointeur vers l’énumérateur IEnumDiskQuotaUsers .

Valeur retournée

Cette méthode retourne 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é.
E_INVALIDARG	Le paramètre ppEnum est NULL.
E_OUTOFMEMORY	Mémoire insuffisante.
E_UNEXPECTED	Une exception inattendue s’est produite.

Configuration requise

Condition requise	Valeur
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