Share via

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