Share via

IDiskQuotaControl：：FindUserName 方法 (dskquota.h)

  • 發行項

找出磁片區配額資訊中的特定專案。 使用者的帳戶登入名稱會當做搜尋金鑰使用。

語法

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

參數

[in] pszLogonName

使用者帳戶登入名稱的指標。

[out] ppUser

IDiskQuotaUser介面指標的指標，指向配額使用者物件。

傳回值

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

傳回碼 描述
S_OK
 成功。
ERROR_ACCESS_DENIED
 呼叫端的存取權限不足。
ERROR_INVALID_SID
 使用者的 SID 無效。
ERROR_NONE_MAPPED
 SID 沒有可用的對應。
ERROR_NOT_READY
 DiskQuotaControl物件未初始化。
E_INVALIDARG
 pUserSid或ppUser參數為Null。
E_OUTOFMEMORY
 記憶體不足。
E_FAIL
 發生非預期的檔案系統錯誤。
E_UNEXPECTED
 發生未預期的例外狀況。

備註

即使配額檔案中沒有使用者的配額記錄，這個方法仍會傳回使用者物件。 這與自動新增使用者和預設配額設定的概念一致。 如果要求的使用者目前沒有配額專案，而且如果使用者要求磁碟空間，則會將使用者新增至配額檔案，則傳回的使用者物件會有警告臨界值，且硬式配額限制等於磁片區預設設定。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 dskquota.h
Dll Dskquota.dll

另請參閱

磁片管理介面

磁片配額

IDiskQuotaControl