Principal.GetGroups 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

傳回群組物件的集合，指定目前的主體是哪些群組的成員。

多載

GetGroups()	傳回群組物件的集合，指定目前的主體是哪些群組的成員。
GetGroups(PrincipalContext)	傳回群組物件的集合，這些群組物件代表的群組不但是主體所屬的群組，而且存在於指定之內容參數所提供的存放區內。

備註

這個多載方法只會傳回主體直接為成員的群組;不會執行遞迴搜尋。 遞迴搜尋結果適用于使用者主體物件。 如需詳細資訊，請參閱 GetAuthorizationGroups 方法。

如果主體存放區是 AD DS，群組清單會包含 AD DS 物件中主要群組識別碼屬性所識別的使用者主要群組。

GetGroups()

傳回群組物件的集合，指定目前的主體是哪些群組的成員。

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)

傳回

PrincipalSearchResult<Principal>

GroupPrincipal 物件的集合，指定目前的主體是哪些群組的成員。

屬性

SecurityCriticalAttribute

備註

這個方法只會傳回主體直接為成員的群組;不會執行遞迴搜尋。 遞迴搜尋結果適用于使用者主體物件。 如需詳細資訊，請參閱 GetAuthorizationGroups 方法。

這個方法所傳回的群組可能包含來自不同範圍的群組，以及與主體不同的存放區。 例如，如果主體是一個 AD DS 物件，其 DN 為 「CN=SpecialGroups，DC=Fabrikam，DC=com，則傳回的集合可以包含屬於 」CN=NormalGroups，DC=Fabrikam，DC=com 的群組。

如果目前的主體是 AD DS 主體，則傳回的群組會包含主體主要群組，如 AD DS 物件上的 「primaryGroupId」 屬性所表示。

另請參閱

• GetGroups()

GetGroups(PrincipalContext)

傳回群組物件的集合，這些群組物件代表的群組不但是主體所屬的群組，而且存在於指定之內容參數所提供的存放區內。

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 物件，指定要執行查詢的內容。

當內容位於其他網域時，會對主體物件在所指定內容中的表示執行查詢。

傳回

PrincipalSearchResult<Principal>

GroupPrincipal 物件的集合，指定目前的主體是哪些群組的成員。

屬性

SecurityCriticalAttribute

備註

這個方法只會傳回主體直接為成員的群組;不會執行遞迴搜尋。 遞迴搜尋結果適用于使用者主體物件。 如需詳細資訊，請參閱 GetAuthorizationGroups 方法。

這個方法所傳回的群組可能包含來自不同範圍的群組，以及與主體不同的存放區。 例如，如果主體是一個 AD DS 物件，其 DN 為 「CN=SpecialGroups，DC=Fabrikam，DC=com，則傳回的集合可以包含屬於 」CN=NormalGroups，DC=Fabrikam，DC=com 的群組。

如果目前的主體是 AD DS 主體，則傳回的群組會包含主體主要群組，如 AD DS 物件上的主要群組識別碼屬性所指出。

另請參閱

• GetGroups()