IDiskQuotaControl：：FindUserName 方法 (dskquota.h)
找出磁片區配額資訊中的特定專案。 使用者的帳戶登入名稱會當做搜尋金鑰使用。
語法
HRESULT FindUserName(
[in] LPCWSTR pszLogonName,
[out] PDISKQUOTA_USER *ppUser
);
參數
[in] pszLogonName
使用者帳戶登入名稱的指標。
[out] ppUser
IDiskQuotaUser介面指標的指標，指向配額使用者物件。
傳回值
這個方法會傳回檔案系統錯誤或下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
呼叫端的存取權限不足。 |
|
使用者的 SID 無效。 |
|
SID 沒有可用的對應。 |
|
DiskQuotaControl物件未初始化。 |
|
pUserSid或ppUser參數為Null。 |
|
記憶體不足。 |
|
發生非預期的檔案系統錯誤。 |
|
發生未預期的例外狀況。 |
備註
即使配額檔案中沒有使用者的配額記錄，這個方法仍會傳回使用者物件。 這與自動新增使用者和預設配額設定的概念一致。 如果要求的使用者目前沒有配額專案，而且如果使用者要求磁碟空間，則會將使用者新增至配額檔案，則傳回的使用者物件會有警告臨界值，且硬式配額限制等於磁片區預設設定。
需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | dskquota.h |
| Dll | Dskquota.dll |