IDiskQuotaControl::AddUserName-Methode (dskquota.h)

Artikel
08/23/2023

Fügt einen neuen Kontingenteintrag auf dem Volume für den angegebenen Benutzer hinzu. Der Benutzer wird durch Domänen- und Kontoname identifiziert.

Syntax

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

Parameter

[in] pszLogonName

Die Anmeldenamenzeichenfolge des Benutzerkontos.

[in] fNameResolution

Gibt an, wie die Benutzerkontoinformationen abgerufen werden sollen. Die Kontingentinformationen des Volumes identifizieren Benutzer anhand der SID. Die Benutzerkontoinformationen (z. B. Container, Anmeldename und Anzeigename) 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. AddUserName 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 eine 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. AddUserName gibt zurück, wenn die Informationen aufgelöst werden. Wenn die Informationen im SID-Cache des Datenträgerkontingents 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.
S_FALSE	Der Benutzer ist bereits vorhanden. Nicht hinzugefügt.
ERROR_NOT_READY	Das DiskQuotaControl-Objekt wird nicht initialisiert.
ERROR_USER_UNKNOWN	Der angegebene Benutzername ist unbekannt.
E_INVALIDARG	Ein Zeigerparameter ist NULL.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
E_FAIL	Ein unerwarteter Dateisystemfehler ist aufgetreten.
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 in das Volume geschrieben hat. Daher können Sie vorab einen Warnungsschwellenwert oder einen Grenzwert für hartes Kontingent zuweisen, der sich von den Standardeinstellungen des Volumes unterscheidet.

Anforderungen


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