DiskQuotaControl.TranslateLogonNameToSID メソッド

  • [アーティクル]

ログオン名を、対応するユーザー セキュリティ ID に文字列形式で変換します。

構文

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

パラメーター

logonname

型: 文字列

ユーザーのログオン名を指定する文字列値。

戻り値

指定されたログオン名に対応する文字列形式でユーザー セキュリティ ID (SID) を返します。 返される文字列には、標準の囲みかっこが含まれます。 次に例を示します。

"{S-1-5-21-2127521184-1604012920-1887927527-19009}"

注釈

返された SID 文字列は、ログオン名の代わりに FindUser メソッドに渡すことができます。

FindUser( logonname) メソッドの呼び出しが失敗した場合、指定されたログオン名と SID 名キャッシュに格納されているフォーム (セキュリティ アカウント マネージャー [SAM] 互換とユーザー プリンシパル名 [UPN]) が一致しない可能性があります。 このような場合、ログオン名を 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 オブジェクト