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

  • [アーティクル]

ボリューム クォータ情報内の特定のエントリを検索します。 ユーザーのアカウント ログオン名が検索キーとして使用されます。

構文

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

パラメーター

[in] pszLogonName

ユーザーのアカウント ログオン名へのポインター。

[out] ppUser

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

戻り値

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

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

解説

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

要件

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

関連項目

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

ディスク クォータ

IDiskQuotaControl