IDiskQuotaControl：：FindUserSid 方法 (dskquota.h)

找出磁片區配額資訊中的特定使用者專案。使用者的安全性識別碼 (SID) 作為搜尋索引鍵。

語法

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

[in] pUserSid

使用者 SID 的指標。

[in] fNameResolution

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

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

[out] ppUser

接收配額使用者物件的 IDiskQuotaUser 介面指標的指標。

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

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