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

Article
02/26/2024

Ajoute une nouvelle entrée de quota sur le volume pour l’utilisateur spécifié. L’utilisateur est identifié par un identificateur de sécurité (SID).

Syntaxe

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

Paramètres

[in] pUserSid

SID de l’utilisateur.

[in] fNameResolution

Indique la façon dont les informations de compte d’utilisateur doivent être obtenues. Les informations de quota du volume identifient les utilisateurs par SID. Les informations de compte d’utilisateur (telles que le nom de domaine, le nom du compte et le nom complet) doivent être obtenues à partir 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. AddUserSid 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ésolvez les informations de compte d’utilisateur de manière synchrone. AddUserSid 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] ppUser

Pointeur vers le pointeur d’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	Réussite.
ERROR_ACCESS_DENIED	Les droits d’accès de l’appelant sont insuffisants.
ERROR_INVALID_SID	Le SDI spécifié est inconnu.
ERROR_NOT_READY	L’objet DiskQuotaControl n’est pas initialisé.
E_INVALIDARG	Le paramètre pUserSid ou ppUser a la valeur 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.

Remarques

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é-attribuer un seuil d’avertissement ou une valeur limite de quota dur différente des paramètres par défaut du volume.

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