Метод IDiskQuotaControl::FindUserName (dskquota.h)

  • Статья

Находит определенную запись в сведениях о квоте тома. В качестве ключа поиска используется имя входа в учетную запись пользователя.

Синтаксис

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

Параметры

[in] pszLogonName

Указатель на имя входа в учетную запись пользователя.

[out] ppUser

Указатель на указатель интерфейса IDiskQuotaUser на объект пользователя квоты.

Возвращаемое значение

Этот метод возвращает ошибку файловой системы или одно из следующих значений.

Код возврата Описание
S_OK
 Успешно.
ERROR_ACCESS_DENIED
 У вызывающего абонента недостаточно прав доступа.
ERROR_INVALID_SID
 Недопустимый идентификатор безопасности для пользователя.
ERROR_NONE_MAPPED
 Нет доступных сопоставлений для идентификатора безопасности.
ERROR_NOT_READY
 Объект DiskQuotaControl не инициализирован.
E_INVALIDARG
 Параметр pUserSid или ppUser имеет значение NULL.
E_OUTOFMEMORY
 Недостаточно памяти.
E_FAIL
 Произошла непредвиденная ошибка файловой системы.
E_UNEXPECTED
 Произошло непредвиденное исключение.

Комментарии

Этот метод возвращает объект пользователя, даже если в файле квоты нет записи о квоте пользователя. Это согласуется с идеей автоматического добавления пользователей и параметров квоты по умолчанию. Если в настоящее время для запрошенного пользователя нет записи квоты и пользователь будет добавлен в файл квоты, если он запрашивает место на диске, возвращенный объект пользователя будет иметь пороговое значение предупреждения и жесткие квоты, равные параметрам тома по умолчанию.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header dskquota.h
DLL Dskquota.dll

См. также раздел

Интерфейсы управления дисками

Дисковые квоты

IDiskQuotaControl