UserPrincipal.FindByIdentity メソッド

定義

名前空間:

System.DirectoryServices.AccountManagement

アセンブリ:

System.DirectoryServices.AccountManagement.dll

パッケージ:

System.DirectoryServices.AccountManagement v8.0.0

指定された ID 値と一致するユーザー プリンシパル オブジェクトを返します。

オーバーロード

FindByIdentity(PrincipalContext, IdentityType, String)	指定された ID の種類および値と一致するユーザー プリンシパル オブジェクトを返します。 このバージョンの FindByIdentity メソッドでは、ID 値の形式が指定されます。
FindByIdentity(PrincipalContext, String)	指定された ID 値と一致するユーザー プリンシパル オブジェクトを返します。

FindByIdentity(PrincipalContext, IdentityType, String)

ソース:

User.cs

指定された ID の種類および値と一致するユーザー プリンシパル オブジェクトを返します。 このバージョンの FindByIdentity メソッドでは、ID 値の形式が指定されます。

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As UserPrincipal

パラメーター

context

PrincipalContext

操作が実行されるサーバーまたはドメインを指定する PrincipalContext。

identityType

IdentityType

identityValue パラメーターの形式を指定する IdentityType 列挙値。

identityValue

String

ユーザー プリンシパルの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。

戻り値

UserPrincipal

指定された ID の値と型に一致する UserPrincipal オブジェクト。一致するオブジェクトが検出されなかった場合は null。

例外

MultipleMatchesException

現在のユーザー オブジェクトと一致する複数のユーザー プリンシパル オブジェクトが見つかりました。

InvalidEnumArgumentException

ID の値は有効な IdentityType 列挙値ではありません。

例

次のコードは、ローカル コンピューター ストアに接続します。 資格情報はコンストラクターで PrincipalContext 指定されていないため、現在のスレッドを実行しているユーザーの資格情報が使用されます。

SamAccountName "Guest" を持つユーザーを検索する検索が実行されます。

ユーザーが見つかった場合は、このユーザーのアカウントが有効になっているかどうかを判断するためにチェックが実行されます。 アカウントが有効になっていない場合は、コード例で有効にします。

PrincipalContext ctx = new PrincipalContext(ContextType.Machine);  

UserPrincipal usr = UserPrincipal.FindByIdentity(ctx,   
                                           IdentityType.SamAccountName,   
                                           "Guest");  

if(usr != null)  
{  
    if (usr.Enabled == false)  
        usr.Enabled = true;  

    usr.Save();  
    usr.Dispose();  
}  
ctx.Dispose();   

FindByIdentity(PrincipalContext, String)

ソース:

User.cs

指定された ID 値と一致するユーザー プリンシパル オブジェクトを返します。

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As UserPrincipal

パラメーター

context

PrincipalContext

操作が実行されるサーバーまたはドメインを指定する PrincipalContext。

identityValue

String

ユーザー プリンシパルの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。

戻り値

UserPrincipal

UserPrincipal オブジェクト。指定した ID の値と一致し、一致する値が見つからない場合は null になります。

例外

MultipleMatchesException

現在のユーザー オブジェクトと一致する複数のユーザー プリンシパル オブジェクトが見つかりました。