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 介面指標指標。

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

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