次の方法で共有

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

  • [アーティクル]

指定したユーザーのボリュームに新しいクォータ エントリを追加します。 ユーザーはドメイン名とアカウント名で識別されます。

構文

HRESULT AddUserName(
  [in]  LPCWSTR         pszLogonName,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

パラメーター

[in] pszLogonName

ユーザーのアカウント ログオン名の文字列。

[in] fNameResolution

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

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

[out] ppUser

新しく作成されたクォータ ユーザー オブジェクトへの IDiskQuotaUser インターフェイス ポインターへのポインター。

戻り値

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

リターン コード 説明
S_OK
 成功しました。
S_FALSE
 ユーザーは既に存在します。 追加されていません。
ERROR_NOT_READY
 DiskQuotaControl オブジェクトが初期化されていません。
ERROR_USER_UNKNOWN
 指定されたユーザー名が不明です。
E_INVALIDARG
 ポインター パラメーターが NULL です。
E_OUTOFMEMORY
 メモリ不足です。
E_FAIL
 予期しないファイル システム エラーが発生しました。
E_UNEXPECTED
 予期しない例外が発生しました。

解説

NTFS ファイル システムは、ユーザーが最初にボリュームに書き込むときに、ユーザー クォータ エントリを自動的に作成します。 自動的に作成されるエントリには、ボリュームの既定の警告しきい値とハード クォータ制限値が割り当てられます。 このメソッドを使用すると、ユーザーがボリュームに情報を書き込む前に、ユーザー クォータ エントリを作成できます。 そのため、ボリュームの既定の設定とは異なる警告しきい値またはハード クォータ制限値を事前に割り当てることができます。

要件

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

関連項目

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

ディスク クォータ

IDiskQuotaControl