DiskQuotaControl.FindUser 方法

在磁片區的配額檔案中,依名稱尋找使用者的專案。

語法

DiskQuotaControl.FindUser(
  sLogonName
)

參數

sLogonName

類型: 字串

包含使用者登入名稱的字串值。

傳回值

傳回評估為使用者 DIDiskQuotaUser 物件的物件運算式。

備註

這個方法會傳回 DIDiskQuotaUser 物件,即使配額檔案中沒有使用者的專案也一樣。 傳回的使用者物件具有警告臨界值,且硬性配額限制會設定為磁片區的預設值。

TranslateLogonNameToSID 傳回的字串可能會傳遞來取代 sLogonName 參數。 當 FindUser收到 SID 字串時,它會使用對應的 SID 來直接查閱磁片區上使用者的配額記錄。 這會略過 SID 名稱快取。 如果 FindUser 因為格式不相符, (例如,提供的登入名稱與 SAM 相容和 UPN) ,而且快取的登入名稱,可以使用 TranslateLogonNameToSID 將登入名稱轉譯為 SID 字串,然後再傳遞至 FindUser。 下列 VBScript 程式碼說明這項技術。

Function Find(dqc, name)
    On Error Resume Next
    SET Find = dqc.FindUser(name)

    If Err.Number <> 0 Then
        Err.Clear
        SET Find = dqc.FindUser(dqc.TranslateLogonNameToSID(name))
    End If    

End Function

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
DLL
Shell32.dll (5.0 版或更新版本)

另請參閱

DiskQuotaControl 物件