Export (0) Print
Expand All

X509Certificate2 Constructor (IntPtr)

Initializes a new instance of the X509Certificate2 class using an unmanaged handle.

Namespace:  System.Security.Cryptography.X509Certificates
Assembly:  System (in System.dll)

public X509Certificate2(
	IntPtr handle
)

Parameters

handle
Type: System.IntPtr

A pointer to a certificate context in unmanaged code. The C structure is called PCCERT_CONTEXT.

ExceptionCondition
CryptographicException

An error with the certificate occurs. For example:

  • The certificate file does not exist.

  • The certificate is invalid.

  • The certificate's password is incorrect.

This constructor creates a new X509Certificate2 object using a handle for the Microsoft Cryptographic API certificate context, PCCERT_CONTEXT. Note that the immediate caller of this constructor requires unmanaged code permission.

Important noteImportant

The constructor creates a copy of the certificate context. Do not assume that the context structure you passed to the constructor is valid; it may have been released. You can get a copy of the current PCCERT_CONTEXT structure from the Handle property, but it is valid only during the lifetime of the X509Certificate2 object.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Show:
© 2015 Microsoft