WindowsIdentity コンストラクタ (String, String)

2007-06-26

指定した UPN (User Principal Name) と指定した認証の種類で表されるユーザーを表す WindowsIdentity クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Principal
アセンブリ: mscorlib (mscorlib.dll 内)

構文

'宣言
Public Sub New ( _
    sUserPrincipalName As String, _
    type As String _
)
'使用
Dim sUserPrincipalName As String
Dim type As String

Dim instance As New WindowsIdentity(sUserPrincipalName, type)

public WindowsIdentity (
    string sUserPrincipalName,
    string type
)

public:
WindowsIdentity (
    String^ sUserPrincipalName, 
    String^ type
)

public WindowsIdentity (
    String sUserPrincipalName, 
    String type
)

public function WindowsIdentity (
    sUserPrincipalName : String, 
    type : String
)

適用できません。

パラメータ

sUserPrincipalName
コードが実行されている対象ユーザーの UPN。

type
ユーザーを識別するために使用する認証の種類。

例外

例外の種類	条件
UnauthorizedAccessException	Windows は、Windows NT ステータスコード STATUS_ACCESS_DENIED を返しました。
OutOfMemoryException	使用できるメモリが不足しています。
SecurityException	呼び出し元に、正しいアクセス許可がありません。

解説

sUserPrincipalName が示す UPN は、そのユーザーのトークンを Win32 API の LsaLogonUser 関数の呼び出しによって取得するために使用されます。つまり、トークンはユーザーを識別するために使用されます。与えられた UPN を使用してログオンできないために、例外が返される場合もあります。

メモ :
このコンストラクタは、Windows Server 2003 ドメインに参加しているコンピュータでの使用を想定しています。その他のドメインタイプでは、例外がスローされます。

.NET Framework のセキュリティ

SecurityPermission (プリンシパルオブジェクトを操作するために必要なアクセス許可)。SecurityPermissionFlag.ControlPrincipal (関連する列挙体)。
SecurityPermission (アンマネージコードにアクセスするために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1