IDiskQuotaControl：：CreateEnumUsers 方法 (dskquota.h)

建立列舉值物件，以列舉磁碟區上的配額使用者。 新建立的物件會實作 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

指出如何取得用戶帳戶資訊。 磁碟區的配額資訊會依 SID 識別使用者。 用戶帳戶資訊 (，例如功能變數名稱、帳戶名稱和完整名稱) 必須從網路域控制器取得，如果不是在網路上，則必須從本機計算機取得。 此參數可以是下列其中一個值。

值	意義
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	以異步方式解析用戶帳戶資訊。 IEnumDiskQuotaUsers：：Next 方法會立即傳回。 呼叫端必須實作 IDiskQuotaEvents 介面，才能在資訊可用時接收通知。 如果在先前的要求期間快取資訊，則會在服務物件時立即發出通知。 否則，方法會從網路域控制器取得資訊，然後通知 IDiskQuotaEvents。
DISKQUOTA_USERNAME_RESOLVE_NONE 0	請勿解析用戶帳戶資訊。
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	同步解析用戶帳戶資訊。 解析資訊時 ，IEnumDiskQuotaUsers：：Next 方法會傳回。 如果磁碟配額 SID 快取中存在資訊，則會立即傳回它。 否則，方法必須找出資訊。 這可能需要數秒鐘的時間。

[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
標頭	dskquota.h
Dll	Dskquota.dll

另請參閱

磁碟管理介面

磁碟配額

IDiskQuotaControl