IDiskQuotaControl::AddUserSid メソッド (dskquota.h)
指定したユーザーのボリュームに新しいクォータ エントリを追加します。 ユーザーは、セキュリティ識別子 (SID) によって識別されます。
構文
HRESULT AddUserSid(
[in] PSID pUserSid,
[in] DWORD fNameResolution,
[out] PDISKQUOTA_USER *ppUser
);
パラメーター
[in] pUserSid
ユーザーの SID。
[in] fNameResolution
ユーザー アカウント情報を取得する方法を示します。 ボリュームのクォータ情報は、SID によってユーザーを識別します。 ユーザー アカウント情報 (ドメイン名、アカウント名、フル ネームなど) は、ネットワーク ドメイン コントローラーから取得するか、ネットワーク上にない場合はローカル コンピューターから取得する必要があります。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
ユーザー アカウント情報を非同期的に解決します。 AddUserSid は直ちにを返します。 呼び出し元は、情報が使用可能になったときに通知を受け取るために IDiskQuotaEvents インターフェイスを実装する必要があります。 前の要求中に情報がキャッシュされた場合は、オブジェクトが処理されるとすぐに通知が発生します。 それ以外の場合、メソッドはネットワーク ドメイン コントローラーから情報を取得し、 IDiskQuotaEvents に通知します。 |
|
ユーザー アカウント情報を解決しないでください。 |
|
ユーザー アカウント情報を同期的に解決します。 AddUserSid は、情報が解決されると を返します。 ディスク クォータ SID キャッシュに情報が存在する場合は、すぐに返されます。 それ以外の場合、メソッドは情報を見つける必要があります。 これには数秒かかる場合があります。 |
[out] ppUser
新しく作成されたクォータ ユーザー オブジェクトへの IDiskQuotaUser インターフェイス ポインターへのポインター。
戻り値
このメソッドは、ファイル システム エラーまたは次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
呼び出し元に十分なアクセス権がありません。 |
|
指定した SDI が不明です。 |
|
DiskQuotaControl オブジェクトが初期化されていません。 |
|
pUserSid または ppUser パラメーターが NULL です。 |
|
メモリ不足です。 |
|
予期しないファイル システム エラーが発生しました。 |
|
予期しない例外が発生しました。 |
注釈
NTFS ファイル システムは、ユーザーが最初にボリュームに書き込むときに、ユーザー クォータ エントリを自動的に作成します。 自動的に作成されるエントリには、ボリュームの既定の警告しきい値とハード クォータ制限値が割り当てられます。 このメソッドを使用すると、ユーザーがボリュームに情報を書き込む前に、ユーザー クォータ エントリを作成できます。 そのため、ボリュームの既定の設定とは異なる警告しきい値またはハード クォータ制限値を事前に割り当てることができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | dskquota.h |
| [DLL] | Dskquota.dll |