Share via

DiskQuotaControl.TranslateLogonNameToSID 方法

  • 發行項

以字串格式將登入名稱轉譯為對應的使用者安全性識別碼。

語法

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

參數

logonname

類型： 字串

指定使用者登入名稱的字串值。

傳回值

以對應至所提供登入名稱的字串格式，傳回 SID (SID) 的使用者安全性識別碼。 傳回的字串包含標準括住大括弧。 例如：

「{S-1-5-21-2127521184-1604012920-1887927527-19009}」

備註

傳回的 SID 字串可以傳遞至 FindUser 方法，以取代登入名稱。

當 呼叫 FindUser ( logonname) 方法失敗時，可能是因為表單 ( (不相容，以及所提供登入名稱的使用者主體名稱 [UPN]) ，以及儲存在 SID 名稱快取中的表單。 在這種情況下，登入名稱可以轉換成 SID，並重複呼叫 FindUser 。 FindUser 會辨識 SID 字串，並略過 SID 名稱快取查閱。 下列 Microsoft Visual Basic Scripting Edition (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

相較于 SID 名稱快取中的查閱，名稱到 SID 轉譯可能是緩慢的程式。 因此，建議先使用登入名稱呼叫 FindUser 。 上述範例會使用這項技術。

規格需求

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

另請參閱

DiskQuotaControl 物件