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