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

Статья
03/05/2024

Создает объект перечислителя для перечисления пользователей квоты на томе. Созданный объект реализует интерфейс IEnumDiskQuotaUsers .

Синтаксис

HRESULT CreateEnumUsers(
  [in]  PSID                  *rgpUserSids,
  [in]  DWORD                 cpSids,
  [in]  DWORD                 fNameResolution,
  [out] PENUM_DISKQUOTA_USERS *ppEnum
);

Параметры

[in] rgpUserSids

Массив указателей идентификатора безопасности (SID), представляющий пользовательские объекты, которые будут включены в перечисление. Если это значение равно NULL, перечисляются все пользовательские записи.

[in] cpSids

Количество элементов в массиве rgpUserSids . Игнорируется, если rgpUserSids имеет значение NULL.

[in] fNameResolution

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

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

[out] ppEnum

Указатель на указатель на перечислитель IEnumDiskQuotaUsers .

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

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

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

Требования

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

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

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

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

IDiskQuotaControl

Поделиться через