Principal.GetGroups Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает коллекцию объектов групп, указывающих группы, в которые входит текущий участник.
Перегрузки
GetGroups() |
Возвращает коллекцию объектов групп, указывающих группы, в которые входит текущий участник. |
GetGroups(PrincipalContext) |
Возвращает коллекцию объектов групп, в которые входит участник и которые существуют в хранилище, заданном в параметре контекста. |
Комментарии
Этот перегруженный метод возвращает только те группы, участником которых является субъект; рекурсивный поиск не выполняется. Рекурсивные результаты поиска доступны для объектов субъекта-пользователя. Дополнительные сведения см. в описании метода GetAuthorizationGroups.
Если основным хранилищем является AD DS, список групп содержит основную группу пользователя, определяемую атрибутом идентификатора основной группы в объекте AD DS.
GetGroups()
- Исходный код:
- Principal.cs
- Исходный код:
- Principal.cs
- Исходный код:
- Principal.cs
Возвращает коллекцию объектов групп, указывающих группы, в которые входит текущий участник.
public:
System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups();
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups ();
[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups ();
member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
[<System.Security.SecurityCritical>]
member this.GetGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetGroups () As PrincipalSearchResult(Of Principal)
Возвращаемое значение
Коллекция GroupPrincipal объектов, указывающих группы, в которые входит текущий участник.
- Атрибуты
Комментарии
Этот метод возвращает только те группы, участником которых является субъект. рекурсивный поиск не выполняется. Рекурсивные результаты поиска доступны для объектов субъекта-пользователя. Дополнительные сведения см. в описании метода GetAuthorizationGroups.
Группы, возвращаемые этим методом, могут включать группы из область и хранилища, отличных от основного. Например, если субъект является объектом AD DS с DN "CN=SpecialGroups,DC=Fabrikam,DC=com, возвращаемый набор может содержать группы, принадлежащие "CN=NormalGroups,DC=Fabrikam,DC=com.
Если текущий субъект является субъектом AD DS, возвращаемые группы включают основную группу субъектов, как указано атрибутом primaryGroupId объекта AD DS.
См. также раздел
Применяется к
GetGroups(PrincipalContext)
- Исходный код:
- Principal.cs
- Исходный код:
- Principal.cs
- Исходный код:
- Principal.cs
Возвращает коллекцию объектов групп, в которые входит участник и которые существуют в хранилище, заданном в параметре контекста.
public:
System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetGroups(System::DirectoryServices::AccountManagement::PrincipalContext ^ contextToQuery);
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups (System.DirectoryServices.AccountManagement.PrincipalContext contextToQuery);
[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetGroups (System.DirectoryServices.AccountManagement.PrincipalContext contextToQuery);
member this.GetGroups : System.DirectoryServices.AccountManagement.PrincipalContext -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
[<System.Security.SecurityCritical>]
member this.GetGroups : System.DirectoryServices.AccountManagement.PrincipalContext -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetGroups (contextToQuery As PrincipalContext) As PrincipalSearchResult(Of Principal)
Параметры
- contextToQuery
- PrincipalContext
Объект PrincipalContext, указывающий контекст, в отношении которого выполняется запрос.
Если контекст расположен в другом домене, запрос выполняется в отношении представления объекта-участника в указанном контексте.
Возвращаемое значение
Коллекция GroupPrincipal объектов, указывающих группы, в которые входит текущий участник.
- Атрибуты
Комментарии
Этот метод возвращает только те группы, участником которых является субъект. рекурсивный поиск не выполняется. Рекурсивные результаты поиска доступны для объектов субъекта-пользователя. Дополнительные сведения см. в описании метода GetAuthorizationGroups.
Группы, возвращаемые этим методом, могут включать группы из область и хранилища, отличных от основного. Например, если субъект является объектом AD DS с DN "CN=SpecialGroups,DC=Fabrikam,DC=com, возвращаемый набор может содержать группы, принадлежащие "CN=NormalGroups,DC=Fabrikam,DC=com.
Если текущий субъект является субъектом AD DS, возвращаемые группы включают основную группу субъектов, как указано атрибутом идентификатора основной группы в объекте AD DS.