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

Значение перечисления IdentityType, определяющее формат параметра identityValue.

identityValue

String

Удостоверение участника-группы. Этот параметр может иметь любой формат, содержащийся в перечислении IdentityType.

Возвращаемое значение

GroupPrincipal

Объект GroupPrincipal, соответствующий значению и типу заданного удостоверения, или значение NULL, если соответствий не найдено.

Исключения

MultipleMatchesException

Было найдено несколько объектов участников-групп, соответствующих текущему объекту-группе.

InvalidEnumArgumentException

Значение удостоверения недопустимо для значения перечисления IdentityType.