This topic has not yet been rated - Rate this topic

CspProviderFlags Enumeration

.NET Framework 4.5

Other Versions

Specifies flags that modify the behavior of the cryptographic service providers (CSP).

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

Syntax

C++

[SerializableAttribute]
[ComVisibleAttribute(true)]
[FlagsAttribute]
public enum CspProviderFlags

Members

Member name

Description

NoFlags

Do not specify any settings.

UseMachineKeyStore

Use key information from the computer's key store.

UseDefaultKeyContainer

Use key information from the default key container.

UseNonExportableKey

Use key information that cannot be exported.

UseExistingKey

Use key information from the current key.

UseArchivableKey

Allow a key to be exported for archival or recovery.

UseUserProtectedKey

Notify the user through a dialog box or another method when certain actions are attempting to use a key. This flag is not compatible with the NoPrompt flag.

NoPrompt

Prevent the CSP from displaying any user interface (UI) for this context.

CreateEphemeralKey

Create a temporary key that is released when the associated Rivest-Shamir-Adleman (RSA) object is closed. Do not use this flag if you want your key to be independent of the RSA object.

Important

The CreateEphemeralKey flag provides temporary keys with more reliable cleanup. If this flag is not used, the common language runtime (CLR) generates a randomly named key when an RSA object is created. When the object is finalized or disposed of, the key is deleted. When impersonation is in effect, not explicitly calling Dispose can potentially create a problem. For example, if you use impersonation, create an RSA object, and do not dispose of it, the finalizer thread (which is not impersonating) can fail to delete the key, and then throws an exception. This exception is unhandled and can terminate the process. The resources allocated to the key are not recovered, resulting in a memory leak. The KeyContainerPermission demand is suppressed by this flag.

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

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.

Reference

System.Security.Cryptography Namespace

Other Resources

Cryptographic Services

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)