UserPrincipal.GetAuthorizationGroups メソッド

定義

このユーザーがメンバーであるすべての認証グループを含むプリンシパル オブジェクトのコレクションを返します。 この関数が返すグループは、セキュリティ グループだけです。配布グループは返しません。

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetAuthorizationGroups();
public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetAuthorizationGroups ();
member this.GetAuthorizationGroups : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>
Public Function GetAuthorizationGroups () As PrincipalSearchResult(Of Principal)

戻り値

ユーザーがメンバーであるグループを含むオブジェクトのコレクション Principal 。ユーザーがセキュリティ グループに属していない場合は null。

例外

認証グループの取得に失敗しました。

このオペレーティング システムでは、認証グループの取得はサポートされていません。

注釈

このメソッドは、すべてのグループを再帰的に検索し、ユーザーがメンバーであるグループを返します。 返されるセットには、承認のためにシステムがユーザーをメンバーと見なす追加のグループも含まれる場合があります。

このメソッドによって返されるグループには、プリンシパルとは異なるスコープとストアのグループが含まれる場合があります。 たとえば、プリンシパルが "CN=SpecialGroups,DC=Fabrikam,DC=com" の DN を持つ AD DS オブジェクトである場合、返されるセットには"CN=NormalGroups,DC=Fabrikam,DC=com" に属するグループを含めることができます。

適用対象