IDiskQuotaControl::AddUserName-Methode (dskquota.h)

  • Artikel

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