Rfc2898DeriveBytes::CryptDeriveKey Method (String^, String^, Int32, array<Byte>^)

.NET Framework (current version)
 

Derives a cryptographic key from the Rfc2898DeriveBytes object.

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

public:
array<unsigned char>^ CryptDeriveKey(
	String^ algname,
	String^ alghashname,
	int keySize,
	array<unsigned char>^ rgbIV
)

Parameters

algname
Type: System::String^

The algorithm name for which to derive the key.

alghashname
Type: System::String^

The hash algorithm name to use to derive the key.

keySize
Type: System::Int32

The size of the key, in bits, to derive.

rgbIV
Type: array<System::Byte>^

The initialization vector (IV) to use to derive the key.

Return Value

Type: array<System::Byte>^

The derived key.

Exception Condition
CryptographicException

The keySize parameter is incorrect.

-or-

The cryptographic service provider (CSP) cannot be acquired.

-or-

The algname parameter is not a valid algorithm name.

-or-

The alghashname parameter is not a valid hash algorithm name.

This function is a wrapper for the Crypto API function CryptDeriveKey(), and is intended to offer interoperability with applications using the Crypto API.

If the keySize parameter is set to 0 bits, the default key size for the specified algorithm is used.

.NET Framework
Available since 4.6
Return to top
Show: