IDiskQuotaControl::FindUserSid-Methode (dskquota.h)

Artikel
08/23/2023

Sucht einen bestimmten Benutzereintrag in den Volumekontingentinformationen. Die Sicherheits-ID (SID) des Benutzers wird als Suchschlüssel verwendet.

Syntax

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

Parameter

[in] pUserSid

Ein Zeiger auf 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. FindUserSid wird sofort zurückgegeben. 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. FindUserSid gibt zurück, wenn die Informationen aufgelöst wurden. 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

Zeiger zum Empfangen des IDiskQuotaUser-Schnittstellenzeigers auf das 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_NOT_READY	Das DiskQuotaControl-Objekt wird nicht initialisiert.
ERROR_INVALID_SID	Die SID für den Benutzer ist ungültig.
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

Diese Methode gibt ein Benutzerobjekt zurück, auch wenn in der Kontingentdatei kein Kontingentdatensatz für den Benutzer vorhanden ist. Dies entspricht der Idee der automatischen Benutzerzugabe und der Standardkontingenteinstellungen. Wenn derzeit kein Kontingenteintrag für den angeforderten Benutzer vorhanden ist und der Benutzer der Kontingentdatei hinzugefügt würde, wenn er Speicherplatz anfordern würde, weist das zurückgegebene Benutzerobjekt einen Warnschwellenwert und feste Kontingentgrenzwerte auf, die den Standardeinstellungen des Volumes entsprechen.

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