Principal.FindByIdentity Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns a principal object that matches the specified identity value.
Overloads
| FindByIdentity(PrincipalContext, String) |
Returns a principal object that matches the specified identity value. |
| FindByIdentity(PrincipalContext, IdentityType, String) |
Returns a principal object that matches the specified identity type, and value. This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value. |
FindByIdentity(PrincipalContext, String)
- Source:
- Principal.cs
- Source:
- Principal.cs
- Source:
- Principal.cs
Returns a principal object that matches the specified identity value.
public:
static System::DirectoryServices::AccountManagement::Principal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);public static System.DirectoryServices.AccountManagement.Principal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);[System.Security.SecurityCritical]
public static System.DirectoryServices.AccountManagement.Principal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.Principal[<System.Security.SecurityCritical>]
static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.PrincipalPublic Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As PrincipalParameters
- context
- PrincipalContext
The PrincipalContext that specifies the server or domain against which operations are performed.
- identityValue
- String
The identity of the principal. This parameter can be any format that is contained in the IdentityType enumeration.
Returns
A Principal object that matches the specified identity value and type, or null if no matches are found.
- Attributes
Exceptions
Multiple principal objects matching the current object were found.
Applies to
FindByIdentity(PrincipalContext, IdentityType, String)
- Source:
- Principal.cs
- Source:
- Principal.cs
- Source:
- Principal.cs
Returns a principal object that matches the specified identity type, and value. This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.
public:
static System::DirectoryServices::AccountManagement::Principal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);public static System.DirectoryServices.AccountManagement.Principal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);[System.Security.SecurityCritical]
public static System.DirectoryServices.AccountManagement.Principal 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.Principal[<System.Security.SecurityCritical>]
static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.PrincipalPublic Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As PrincipalParameters
- context
- PrincipalContext
The PrincipalContext that specifies the server or domain against which operations are performed.
- identityType
- IdentityType
An IdentityType enumeration value that specifies the format of the identityValue parameter.
- identityValue
- String
The identity of the principal. This parameter can be any format that is contained in the IdentityType enumeration.
Returns
A Principal object that matches the specified identity value and type or null if no matches are found.
- Attributes
Exceptions
Multiple principal objects matching the current object were found.
The identity type is not a valid IdentityType enumeration value.
