Principal.GetGroups 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回组对象的集合,这些对象指定当前主体是其成员的组。
重载
GetGroups() |
返回组对象的集合,这些对象指定当前主体是其成员的组。 |
GetGroups(PrincipalContext) |
返回组对象的集合,主体是这些对象的成员,并且这些对象存在于由指定的上下文参数提供的存储区中。 |
注解
此重载方法仅返回主体是其直接成员的组;不执行递归搜索。 递归搜索结果可用于用户主体对象。 有关更多信息,请参见 GetAuthorizationGroups 方法。
如果主体存储是 AD DS,则组列表包含用户的主要组,该组由 AD DS 对象中的主组 ID 属性标识。
GetGroups()
- Source:
- Principal.cs
- Source:
- Principal.cs
- Source:
- 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 方法。
此方法返回的组可能包含与主体不同的作用域和存储区中的组。 例如,如果主体是 DN 为“CN=SpecialGroups,DC=Fabrikam,DC=com”的 AD DS 对象,则返回的集可以包含属于“CN=NormalGroups,DC=Fabrikam,DC=com”的组。
如果当前主体是 AD DS 主体,则返回的组包括主体主组,如 AD DS 对象上的“primaryGroupId”属性所示。
另请参阅
适用于
GetGroups(PrincipalContext)
- Source:
- Principal.cs
- Source:
- Principal.cs
- Source:
- 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 方法。
此方法返回的组可能包含与主体不同的作用域和存储区中的组。 例如,如果主体是 DN 为“CN=SpecialGroups,DC=Fabrikam,DC=com”的 AD DS 对象,则返回的集可以包含属于“CN=NormalGroups,DC=Fabrikam,DC=com”的组。
如果当前主体是 AD DS 主体,则返回的组包括由 AD DS 对象上的主要组 ID 属性指示的主体主组。