IDiskQuotaControl::FindUserSid メソッド (dskquota.h)

  • [アーティクル]

ボリューム クォータ情報内の特定のユーザー エントリを検索します。 ユーザーのセキュリティ識別子 (SID) が検索キーとして使用されます。

構文

HRESULT FindUserSid(
  [in]  PSID            pUserSid,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

パラメーター

[in] pUserSid

ユーザーの SID へのポインター。

[in] fNameResolution

ユーザー アカウント情報を取得する方法を示します。 ボリュームのクォータ情報は、SID によってユーザーを識別します。 ユーザー アカウント情報 (ドメイン名、アカウント名、フル ネームなど) は、ネットワーク ドメイン コントローラーから取得するか、ネットワーク上にない場合はローカル コンピューターから取得する必要があります。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
DISKQUOTA_USERNAME_RESOLVE_ASYNC
2
 ユーザー アカウント情報を非同期的に解決します。 FindUserSid は直ちにを返します。 呼び出し元は、情報が使用可能になったときに通知を受け取るために IDiskQuotaEvents インターフェイスを実装する必要があります。 前の要求中に情報がキャッシュされた場合は、オブジェクトが処理されるとすぐに通知が発生します。 それ以外の場合、メソッドはネットワーク ドメイン コントローラーから情報を取得し、 IDiskQuotaEvents に通知します。
DISKQUOTA_USERNAME_RESOLVE_NONE
0
 ユーザー アカウント情報を解決しないでください。
DISKQUOTA_USERNAME_RESOLVE_SYNC
1
 ユーザー アカウント情報を同期的に解決します。 FindUserSid は、情報が解決されると を返します。 ディスク クォータ SID キャッシュに情報が存在する場合は、すぐに返されます。 それ以外の場合、メソッドは情報を見つける必要があります。 これには数秒かかる場合があります。

[out] ppUser

クォータ ユーザー オブジェクトへの IDiskQuotaUser インターフェイス ポインターを受け取るポインター。

戻り値

このメソッドは、ファイル システム エラーまたは次のいずれかの値を返します。

リターン コード 説明
S_OK
 正常終了しました。
ERROR_ACCESS_DENIED
 呼び出し元に十分なアクセス権がありません。
ERROR_NOT_READY
 DiskQuotaControl オブジェクトが初期化されていません。
ERROR_INVALID_SID
 ユーザーの SID が無効です。
E_INVALIDARG
 pUserSid または ppUser パラメーターが NULL です。
E_OUTOFMEMORY
 メモリ不足です。
E_FAIL
 予期しないファイル システム エラーが発生しました。
E_UNEXPECTED
 予期しない例外が発生しました。

解説

このメソッドは、クォータ ファイルにユーザーのクォータ レコードがない場合でも、ユーザー オブジェクトを返します。 これは、自動ユーザー追加と既定のクォータ設定の考え方と一致します。 現在、要求されたユーザーのクォータ エントリがなく、ディスク領域を要求する場合にユーザーがクォータ ファイルに追加される場合、返されるユーザー オブジェクトには警告しきい値が設定され、ハード クォータの制限はボリュームの既定の設定と等しくなります。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー dskquota.h
[DLL] Dskquota.dll

関連項目

ディスク管理インターフェイス

ディスク クォータ

IDiskQuotaControl