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

  • Статья

Добавляет новую запись квоты на том для указанного пользователя. Пользователь идентифицируется по домену и имени учетной записи.

Синтаксис

HRESULT AddUserName(
  [in]  LPCWSTR         pszLogonName,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Параметры

[in] pszLogonName

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

[in] fNameResolution

Указывает, как требуется получить сведения об учетной записи пользователя. Сведения о квоте тома идентифицируют пользователей по идентификатору безопасности. Сведения об учетной записи пользователя (например, контейнере, имени для входа и отображаемом имени) должны быть получены от сетевого контроллера домена или локального компьютера, если он не находится в сети. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
DISKQUOTA_USERNAME_RESOLVE_ASYNC
2
 Асинхронное разрешение сведений об учетной записи пользователя. AddUserName возвращает немедленно. Вызывающий объект должен реализовать интерфейс IDiskQuotaEvents , чтобы получать уведомления о доступности информации. Если данные кэшировались во время предыдущего запроса, уведомление появляется сразу после обслуживания объекта. В противном случае метод получает сведения от сетевого контроллера домена, а затем уведомляет IDiskQuotaEvents.
DISKQUOTA_USERNAME_RESOLVE_NONE
0
 Не разрешайте сведения об учетной записи пользователя.
DISKQUOTA_USERNAME_RESOLVE_SYNC
1
 Синхронное разрешение сведений об учетной записи пользователя. AddUserName возвращает значение при разрешении сведений. Если сведения существуют в кэше идентификаторов безопасности квоты на диск, они возвращаются немедленно. В противном случае метод должен найти сведения. Это может занять несколько минут.

[out] ppUser

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

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

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

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

Комментарии

Файловая система NTFS автоматически создает запись квоты пользователя, когда пользователь впервые записывает данные на том. Автоматически создаваемым записям назначается пороговое значение предупреждения по умолчанию и жесткое ограничение квоты для тома. Этот метод позволяет создать запись квоты пользователя до того, как пользователь записывает сведения в том. Поэтому можно предварительно назначить пороговое значение предупреждения или жесткое ограничение квоты, отличное от параметров тома по умолчанию.

Требования

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

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

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

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

IDiskQuotaControl