IDiskQuotaControl::FindUserName-Methode (dskquota.h)

  • Artikel

Sucht einen bestimmten Eintrag in den Volumekontingentinformationen. Der Anmeldename des Benutzerkontos wird als Suchschlüssel verwendet.

Syntax

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

Parameter

[in] pszLogonName

Ein Zeiger auf den Anmeldenamen des Benutzerkontos.

[out] ppUser

Ein Zeiger auf den IDiskQuotaUser-Schnittstellenzeiger 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_INVALID_SID
 Die SID für den Benutzer ist ungültig.
ERROR_NONE_MAPPED
 Für die SID ist keine Zuordnung verfügbar.
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

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