IDiskQuotaControl：：AddUserSid 方法 (dskquota.h)

為指定的使用者新增磁碟區上的新配額專案。使用者是由安全性標識碼 (SID) 來識別。

語法

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

[in] pUserSid

使用者的 SID。

[in] fNameResolution

指出如何取得用戶帳戶資訊。磁碟區的配額資訊會依 SID 識別使用者。必須從網路域控制器取得使用者帳戶資訊 (，例如功能變數名稱、帳戶名稱和完整名稱) ，如果不是在網路上，則必須從本機計算機取得。此參數可以是下列其中一個值。

值	意義
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	以異步方式解析用戶帳戶資訊。 AddUserSid 會立即傳回。呼叫端必須實作 IDiskQuotaEvents 介面，以在資訊可用時接收通知。如果在上一個要求期間快取資訊，在物件服務後就會立即收到通知。否則，方法會從網路域控制器取得資訊，然後通知 IDiskQuotaEvents。
DISKQUOTA_USERNAME_RESOLVE_NONE 0	請勿解析用戶帳戶資訊。
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	同步解析用戶帳戶資訊。 AddUserSid 會在解析信息時傳回。如果資訊存在於磁碟配額 SID 快取中，則會立即傳回。否則，方法必須找出資訊。這可能需要數秒鐘的時間。

[out] ppUser

新建立配額用戶物件的 IDiskQuotaUser 介面指標指標。

這個方法會傳回檔系統錯誤或下列其中一個值。

當使用者第一次寫入磁碟區時，NTFS 檔系統會自動建立使用者配額專案。自動建立的專案會指派磁碟區的預設警告閾值和硬式配額限制值。這個方法可讓您在使用者將資訊寫入磁碟區之前，先建立使用者配額專案。因此，您可以預先指派與磁碟區預設設定不同的警告閾值或硬性配額限制值。