Export (0) Print
Expand All

SecurityIdentifier Class

Represents a security identifier (SID) and provides marshaling and comparison operations for SIDs.

System.Object
  System.Security.Principal.IdentityReference
    System.Security.Principal.SecurityIdentifier

Namespace:  System.Security.Principal
Assembly:  mscorlib (in mscorlib.dll)

[ComVisibleAttribute(false)]
public sealed class SecurityIdentifier : IdentityReference, 
	IComparable<SecurityIdentifier>

The SecurityIdentifier type exposes the following members.

  NameDescription
Public methodSecurityIdentifier(IntPtr)Initializes a new instance of the SecurityIdentifier class by using an integer that represents the binary form of a security identifier (SID).
Public methodSecurityIdentifier(String)Initializes a new instance of the SecurityIdentifier class by using the specified security identifier (SID) in Security Descriptor Definition Language (SDDL) format.
Public methodSecurityIdentifier(Byte[], Int32)Initializes a new instance of the SecurityIdentifier class by using a specified binary representation of a security identifier (SID).
Public methodSecurityIdentifier(WellKnownSidType, SecurityIdentifier)Initializes a new instance of the SecurityIdentifier class by using the specified well known security identifier (SID) type and domain SID.
Top

  NameDescription
Public propertyAccountDomainSidReturns the account domain security identifier (SID) portion from the SID represented by the SecurityIdentifier object if the SID represents a Windows account SID. If the SID does not represent a Windows account SID, this property returns ArgumentNullException.
Public propertyBinaryLengthReturns the length, in bytes, of the security identifier (SID) represented by the SecurityIdentifier object.
Public propertyValueReturns an uppercase Security Descriptor Definition Language (SDDL) string for the security identifier (SID) represented by this SecurityIdentifier object. (Overrides IdentityReference.Value.)
Top

  NameDescription
Public methodCompareToCompares the current SecurityIdentifier object with the specified SecurityIdentifier object.
Public methodEquals(Object)Returns a value that indicates whether this SecurityIdentifier object is equal to a specified object. (Overrides IdentityReference.Equals(Object).)
Public methodEquals(SecurityIdentifier)Indicates whether the specified SecurityIdentifier object is equal to the current SecurityIdentifier object.
Public methodGetBinaryFormCopies the binary representation of the specified security identifier (SID) represented by the SecurityIdentifier class to a byte array.
Public methodGetHashCodeServes as a hash function for the current SecurityIdentifier object. The GetHashCode method is suitable for hashing algorithms and data structures like a hash table. (Overrides IdentityReference.GetHashCode().)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodIsAccountSidReturns a value that indicates whether the security identifier (SID) represented by this SecurityIdentifier object is a valid Windows account SID.
Public methodIsEqualDomainSidReturns a value that indicates whether the security identifier (SID) represented by this SecurityIdentifier object is from the same domain as the specified SID.
Public methodIsValidTargetTypeReturns a value that indicates whether the specified type is a valid translation type for the SecurityIdentifier class. (Overrides IdentityReference.IsValidTargetType(Type).)
Public methodIsWellKnownReturns a value that indicates whether the SecurityIdentifier object matches the specified well known security identifier (SID) type.
Public methodToStringReturns the security identifier (SID), in Security Descriptor Definition Language (SDDL) format, for the account represented by the SecurityIdentifier object. An example of the SDDL format is S-1-5-9. (Overrides IdentityReference.ToString().)
Public methodTranslateTranslates the account name represented by the SecurityIdentifier object into another IdentityReference-derived type. (Overrides IdentityReference.Translate(Type).)
Top

  NameDescription
Public operatorStatic memberEqualityCompares two SecurityIdentifier objects to determine whether they are equal. They are considered equal if they have the same canonical representation as the one returned by the Value property or if they are both null.
Public operatorStatic memberInequalityCompares two SecurityIdentifier objects to determine whether they are not equal. They are considered not equal if they have different canonical name representations than the one returned by the Value property or if one of the objects is null and the other is not.
Top

  NameDescription
Public fieldStatic memberMaxBinaryLengthReturns the maximum size, in bytes, of the binary representation of the security identifier.
Public fieldStatic memberMinBinaryLengthReturns the minimum size, in bytes, of the binary representation of the security identifier.
Top

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft