GroupPrincipal.FindByIdentity 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

傳回符合指定的識別值之群組主體物件。

多載

FindByIdentity(PrincipalContext, String)	傳回符合指定的識別值之群組主體物件。
FindByIdentity(PrincipalContext, IdentityType, String)	傳回符合指定之識別型別和值的群組主體物件。 這一版的 FindByIdentity 方法會判斷身分識別值的格式。

FindByIdentity(PrincipalContext, String)

來源:

Group.cs

傳回符合指定的識別值之群組主體物件。

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

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

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

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

參數

context

PrincipalContext

針對執行的作業指定伺服器或網域的 PrincipalContext。

identityValue

String

群組主體的識別。 這個參數可以是 IdentityType 列舉中包含的任何格式。

傳回

GroupPrincipal

符合指定的身分識別值和類型的 GroupPrincipal 物件，如果找不到相符項目則為 null。

例外狀況

MultipleMatchesException

找到多個符合目前群組物件的群組主體物件。

FindByIdentity(PrincipalContext, IdentityType, String)

來源:

Group.cs

傳回符合指定之識別型別和值的群組主體物件。 這一版的 FindByIdentity 方法會判斷身分識別值的格式。

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

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

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

參數

context

PrincipalContext

針對執行的作業指定伺服器或網域的 PrincipalContext。

identityType

IdentityType

指定 identityValue 參數格式的 IdentityType 列舉值。

identityValue

String

群組主體的識別。 這個參數可以是 IdentityType 列舉中包含的任何格式。

傳回

GroupPrincipal

符合指定之識別值和型別的 GroupPrincipal，如果找不到符合項目則為 null。

例外狀況

MultipleMatchesException

找到多個符合目前群組物件的群組主體物件。

InvalidEnumArgumentException

身分識別值不是有效的 IdentityType 列舉值。