IDiskQuotaControl::AddUserSid-Methode (dskquota.h)

Artikel
08/23/2023

Fügt dem Volume für den angegebenen Benutzer einen neuen Kontingenteintrag hinzu. Der Benutzer wird durch die Sicherheits-ID (SID) identifiziert.

Syntax

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

Parameter

[in] pUserSid

Die SID des Benutzers.

[in] fNameResolution

Gibt an, wie die Benutzerkontoinformationen abgerufen werden sollen. Die Kontingentinformationen des Volumes identifizieren Benutzer anhand der SID. Die Benutzerkontoinformationen (z. B. Domänenname, Kontoname und vollständiger Name) müssen vom Netzwerkdomänencontroller oder vom lokalen Computer abgerufen werden, wenn er sich nicht in einem Netzwerk befindet. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	Auflösen von Benutzerkontoinformationen asynchron. AddUserSid gibt sofort zurück. Der Aufrufer muss die IDiskQuotaEvents-Schnittstelle implementieren, um Benachrichtigungen zu erhalten, wenn die Informationen verfügbar sind. Wenn die Informationen während einer vorherigen Anforderung zwischengespeichert wurden, erfolgt die Benachrichtigung, sobald das Objekt gewartet wird. Andernfalls ruft die -Methode die Informationen vom Netzwerkdomänencontroller ab und benachrichtigt dann IDiskQuotaEvents.
DISKQUOTA_USERNAME_RESOLVE_NONE 0	Lösen Sie keine Benutzerkontoinformationen auf.
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	Auflösen von Benutzerkontoinformationen synchron. AddUserSid gibt zurück, wenn die Informationen aufgelöst werden. Wenn die Informationen im Datenträgerkontingent-SID-Cache vorhanden sind, werden sie sofort zurückgegeben. Andernfalls muss die -Methode die Informationen suchen. Dies kann mehrere Sekunden dauern.

[out] ppUser

Ein Zeiger auf den IDiskQuotaUser-Schnittstellenzeiger auf das neu erstellte Kontingentbenutzerobjekt.

Rückgabewert

Diese Methode gibt einen Dateisystemfehler oder einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
ERROR_ACCESS_DENIED	Der Aufrufer verfügt über unzureichende Zugriffsrechte.
ERROR_INVALID_SID	Der angegebene SDI ist unbekannt.
ERROR_NOT_READY	Das DiskQuotaControl-Objekt wird nicht initialisiert.
E_INVALIDARG	Der Parameter pUserSid oder ppUser ist NULL.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
E_FAIL	Unerwarteter Dateisystemfehler.
E_UNEXPECTED	Es ist eine unerwartete Ausnahme aufgetreten.

Hinweise

Das NTFS-Dateisystem erstellt automatisch einen Benutzerkontingenteintrag, wenn ein Benutzer zum ersten Mal Daten auf das Volume schreibt. Einträgen, die automatisch erstellt werden, werden der standardmäßige Warnungsschwellenwert und Werte für die harte Kontingentgrenze für das Volume zugewiesen. Mit dieser Methode können Sie einen Benutzerkontingenteintrag erstellen, bevor ein Benutzer Informationen auf das Volume geschrieben hat. Daher können Sie vorab einen Warnungsschwellenwert oder einen grenzwert für festes Kontingent zuweisen, der sich von den Standardeinstellungen des Volumes unterscheidet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dskquota.h
DLL	Dskquota.dll

Weitere Informationen

Schnittstellen für die Datenträgerverwaltung

Datenträgerkontingente

IDiskQuotaControl

Freigeben über