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

Article
08/23/2023

Ajoute une nouvelle entrée de quota sur le volume pour l’utilisateur spécifié. L’utilisateur est identifié par le domaine et le nom du compte.

Syntaxe

HRESULT AddUserName(
  [in]  LPCWSTR         pszLogonName,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Paramètres

[in] pszLogonName

Chaîne de nom d’ouverture de session du compte 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 conteneur, le nom d’ouverture de session et le nom d’affichage) 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. AddUserName 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. AddUserName retourne une fois les informations 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 vers l’interface IDiskQuotaUser vers l’objet utilisateur de quota nouvellement créé.

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	Opération réussie.
S_FALSE	L’utilisateur existe déjà. Non ajouté.
ERROR_NOT_READY	L’objet DiskQuotaControl n’est pas initialisé.
ERROR_USER_UNKNOWN	Le nom d’utilisateur spécifié est inconnu.
E_INVALIDARG	Un paramètre de pointeur 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

Le système de fichiers NTFS crée automatiquement une entrée de quota d’utilisateur lorsqu’un utilisateur écrit pour la première fois dans le volume. Les entrées créées automatiquement se voient attribuer le seuil d’avertissement par défaut et les valeurs limites de quota dur pour le volume. Cette méthode vous permet de créer une entrée de quota d’utilisateur avant qu’un utilisateur ait écrit des informations sur le volume. Par conséquent, vous pouvez pré-affecter un seuil d’avertissement ou une valeur limite de quota dur différente des 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