This topic has not yet been rated - Rate this topic

CngKeyBlobFormat Class

Specifies a key BLOB format for use with Microsoft Cryptography Next Generation (CNG) objects.

System.Object
  System.Security.Cryptography.CngKeyBlobFormat

Namespace:  System.Security.Cryptography
Assembly:  System.Core (in System.Core.dll)
[SerializableAttribute]
[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public sealed class CngKeyBlobFormat : IEquatable<CngKeyBlobFormat>

The CngKeyBlobFormat type exposes the following members.

  Name Description
Public method CngKeyBlobFormat Initializes a new instance of the CngKeyBlobFormat class by using the specified format.
Top
  Name Description
Public property Static member EccPrivateBlob Gets a CngKeyBlobFormat object that specifies a private key BLOB for an elliptic curve cryptography (ECC) key.
Public property Static member EccPublicBlob Gets a CngKeyBlobFormat object that specifies a public key BLOB for an elliptic curve cryptography (ECC) key.
Public property Format Gets the name of the key BLOB format that the current CngKeyBlobFormat object specifies.
Public property Static member GenericPrivateBlob Gets a CngKeyBlobFormat object that specifies a generic private key BLOB.
Public property Static member GenericPublicBlob Gets a CngKeyBlobFormat object that specifies a generic public key BLOB.
Public property Static member OpaqueTransportBlob Gets a CngKeyBlobFormat object that specifies an opaque transport key BLOB.
Public property Static member Pkcs8PrivateBlob Gets a CngKeyBlobFormat object that specifies a Private Key Information Syntax Standard (PKCS #8) key BLOB.
Top
  Name Description
Public method Equals(CngKeyBlobFormat) Compares the specified CngKeyBlobFormat object to the current CngKeyBlobFormat object.
Public method Equals(Object) Compares the specified object to the current CngKeyBlobFormat object. (Overrides Object.Equals(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 GetHashCode Generates a hash value for the embedded key BLOB format in the current CngKeyBlobFormat object. (Overrides Object.GetHashCode().)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ToString Gets the name of the key BLOB format that the current CngKeyBlobFormat object specifies. (Overrides Object.ToString().)
Top
  Name Description
Public operator Static member Equality Determines whether two CngKeyBlobFormat objects specify the same key BLOB format.
Public operator Static member Inequality Determines whether two CngKeyBlobFormat objects do not specify the same key BLOB format.
Top

The CngKeyBlobFormat class is a utility class. It consists of static properties, comparison methods, and a private, internally maintained string that specifies the key BLOB format name.

The static properties return CngKeyBlobFormat objects. Each object's internal string name is initialized to the key BLOB format name that corresponds to the name of the static property.

You can also use this class to create objects for key BLOB formats that are not covered by the static properties.

Several CNG classes (such as CngKey) accept CngKeyBlobFormat objects through a format parameter. When the class receives the CngKeyBlobFormat object, it retrieves the embedded name of the key BLOB format by calling the object's Format property.

Therefore, CngKeyBlobFormat serves as an enumeration of well-known key BLOB formats. It lets you identify a well-known key BLOB format by using a strongly typed value instead of a string.

Note Note

The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: MayLeakOnAbort. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later)

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)
Community Content Add
Annotations FAQ