IDiskQuotaControl::CreateEnumUsers-Methode (dskquota.h)

  • Artikel

Erstellt ein Enumeratorobjekt zum Auflisten von Kontingentbenutzern auf dem Volume. Das neu erstellte Objekt implementiert die IEnumDiskQuotaUsers-Schnittstelle .

Syntax

HRESULT CreateEnumUsers(
  [in]  PSID                  *rgpUserSids,
  [in]  DWORD                 cpSids,
  [in]  DWORD                 fNameResolution,
  [out] PENUM_DISKQUOTA_USERS *ppEnum
);

Parameter

[in] rgpUserSids

Ein Array von SID-Zeigern (Security Identifier), die die Benutzerobjekte darstellen, die in die Enumeration eingeschlossen werden sollen. Wenn dieser Wert NULL ist, werden alle Benutzereinträge aufgelistet.

[in] cpSids

Die Anzahl der Elemente im rgpUserSids-Array . Wird ignoriert, wenn rgpUserSidsNULL ist.

[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. Die IEnumDiskQuotaUsers::Next-Methode 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. Die IEnumDiskQuotaUsers::Next-Methode 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] ppEnum

Ein Zeiger auf einen Zeiger auf den IEnumDiskQuotaUsers-Enumerator .

Rückgabewert

Diese Methode gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
ERROR_ACCESS_DENIED
 Der Aufrufer verfügt über unzureichende Zugriffsrechte.
ERROR_NOT_READY
 Das DiskQuotaControl-Objekt wird nicht initialisiert.
E_INVALIDARG
 Der ppEnum-Parameter ist NULL.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.
E_UNEXPECTED
 Es ist eine unerwartete Ausnahme aufgetreten.

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