IDiskQuotaControl::FindUserName-Methode (dskquota.h)
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 |
|---|---|
|
Erfolg. |
|
Der Aufrufer verfügt über unzureichende Zugriffsrechte. |
|
Die SID für den Benutzer ist ungültig. |
|
Für die SID ist keine Zuordnung verfügbar. |
|
Das DiskQuotaControl-Objekt wird nicht initialisiert. |
|
Der Parameter pUserSid oder ppUser ist NULL. |
|
Nicht genügend Arbeitsspeicher. |
|
Unerwarteter Dateisystemfehler. |
|
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 |