ComputerPrincipal.FindByIdentity メソッド

定義

名前空間:

System.DirectoryServices.AccountManagement

アセンブリ:

System.DirectoryServices.AccountManagement.dll

パッケージ:

System.DirectoryServices.AccountManagement v8.0.0

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

オーバーロード

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

FindByIdentity(PrincipalContext, String)

ソース:

Computer.cs

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

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

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

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

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

パラメーター

context

PrincipalContext

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

identityValue

String

コンピューターの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。

戻り値

ComputerPrincipal

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

例外

MultipleMatchesException

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

FindByIdentity(PrincipalContext, IdentityType, String)

ソース:

Computer.cs

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

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

public static System.DirectoryServices.AccountManagement.ComputerPrincipal 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.ComputerPrincipal

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

パラメーター

context

PrincipalContext

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

identityType

IdentityType

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

identityValue

String

コンピューターの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。

戻り値

ComputerPrincipal

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

例外

MultipleMatchesException

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

InvalidEnumArgumentException

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