GroupPrincipal.FindByIdentity Methode

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Gibt ein Gruppenprinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.

Überlädt

FindByIdentity(PrincipalContext, String)	Gibt ein Gruppenprinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.
FindByIdentity(PrincipalContext, IdentityType, String)	Gibt ein Gruppenprinzipalobjekt zurück, das mit dem angegebenen Identitätstyp und dem angegebenen Identitätswert übereinstimmt. Diese Version der FindByIdentity-Methode bestimmt das Format des Identitätswerts.

FindByIdentity(PrincipalContext, String)

Quelle:

Group.cs

Gibt ein Gruppenprinzipalobjekt zurück, das mit dem angegebenen Identitätswert übereinstimmt.

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

Parameter

context

PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

identityValue

String

Die Identität des Gruppenprinzipals. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.

Gibt zurück

GroupPrincipal

Ein GroupPrincipal-Objekt, das dem angegebenen Identitätswert und -typ entspricht, oder NULL, wenn keine Übereinstimmungen gefunden werden.

Ausnahmen

MultipleMatchesException

Es wurden mehrere Gruppenprinzipalobjekte gefunden, die mit dem aktuellen Gruppenobjekt übereinstimmen.

FindByIdentity(PrincipalContext, IdentityType, String)

Quelle:

Group.cs

Gibt ein Gruppenprinzipalobjekt zurück, das mit dem angegebenen Identitätstyp und dem angegebenen Identitätswert übereinstimmt. Diese Version der FindByIdentity-Methode bestimmt das Format des Identitätswerts.

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

Parameter

context

PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

identityType

IdentityType

Ein IdentityType-Enumerationswert, der das Format des identityValue-Parameters angibt.

identityValue

String

Die Identität des Gruppenprinzipals. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.

Gibt zurück

GroupPrincipal

Ein GroupPrincipal-Objekt, das mit dem angegebenen Identitätswert und mit dem angegebenen Identitätstyp übereinstimmt, oder NULL, wenn keine Übereinstimmungen gefunden werden.

Ausnahmen

MultipleMatchesException

Es wurden mehrere Gruppenprinzipalobjekte gefunden, die mit dem aktuellen Gruppenobjekt übereinstimmen.

InvalidEnumArgumentException

Der Identitätswert ist kein gültiger IdentityType-Enumerationswert.