Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

SecurityIdentifier Class

.NET Framework 4.5

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

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)
C#
C++
F#
VB
Copy 
[ComVisibleAttribute(false)]
public sealed class SecurityIdentifier : IdentityReference, 
	IComparable<SecurityIdentifier>

The SecurityIdentifier type exposes the following members.

  Name Description
Public method SecurityIdentifier(IntPtr) Initializes a new instance of the SecurityIdentifier class by using an integer that represents the binary form of a security identifier (SID).
Public method SecurityIdentifier(String) Initializes a new instance of the SecurityIdentifier class by using the specified security identifier (SID) in Security Descriptor Definition Language (SDDL) format.
Public method SecurityIdentifier(Byte[], Int32) Initializes a new instance of the SecurityIdentifier class by using a specified binary representation of a security identifier (SID).
Public method SecurityIdentifier(WellKnownSidType, SecurityIdentifier) Initializes a new instance of the SecurityIdentifier class by using the specified well known security identifier (SID) type and domain SID.
Top
  Name Description
Public property AccountDomainSid Returns 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 property BinaryLength Returns the length, in bytes, of the security identifier (SID) represented by the SecurityIdentifier object.
Public property Value Returns an uppercase Security Descriptor Definition Language (SDDL) string for the security identifier (SID) represented by this SecurityIdentifier object. (Overrides IdentityReference.Value.)
Top
  Name Description
Public method CompareTo Compares the current SecurityIdentifier object with the specified SecurityIdentifier object.
Public method Equals(Object) Returns a value that indicates whether this SecurityIdentifier object is equal to a specified object. (Overrides IdentityReference.Equals(Object).)
Public method Equals(SecurityIdentifier) Indicates whether the specified SecurityIdentifier object is equal to the current SecurityIdentifier object.
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetBinaryForm Copies the binary representation of the specified security identifier (SID) represented by the SecurityIdentifier class to a byte array.
Public method GetHashCode Serves 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 method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method IsAccountSid Returns a value that indicates whether the security identifier (SID) represented by this SecurityIdentifier object is a valid Windows account SID.
Public method IsEqualDomainSid Returns a value that indicates whether the security identifier (SID) represented by this SecurityIdentifier object is from the same domain as the specified SID.
Public method IsValidTargetType Returns a value that indicates whether the specified type is a valid translation type for the SecurityIdentifier class. (Overrides IdentityReference.IsValidTargetType(Type).)
Public method IsWellKnown Returns a value that indicates whether the SecurityIdentifier object matches the specified well known security identifier (SID) type.
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ToString Returns 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 method Translate Translates the account name represented by the SecurityIdentifier object into another IdentityReference-derived type. (Overrides IdentityReference.Translate(Type).)
Top
  Name Description
Public operator Static member Equality Compares 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 operator Static member Inequality Compares 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
  Name Description
Public field Static member MaxBinaryLength Returns the maximum size, in bytes, of the binary representation of the security identifier.
Public field Static member MinBinaryLength Returns 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 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, 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.
Did you find this helpful?
(1500 characters remaining)