PasswordDeriveBytes.CryptDeriveKey(String, String, Int32, Byte[]) Método

Definição

Namespace:
System.Security.Cryptography
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Deriva uma chave criptográfica do PasswordDeriveBytes objeto.

public:
 cli::array <System::Byte> ^ CryptDeriveKey(System::String ^ algname, System::String ^ alghashname, int keySize, cli::array <System::Byte> ^ rgbIV);
public byte[] CryptDeriveKey(string algname, string alghashname, int keySize, byte[] rgbIV);
member this.CryptDeriveKey : string * string * int * byte[] -> byte[]
Public Function CryptDeriveKey (algname As String, alghashname As String, keySize As Integer, rgbIV As Byte()) As Byte()

Parâmetros

algname
String

O nome do algoritmo para o qual derivar a chave.

alghashname
String

O nome do algoritmo de hash a ser usado para derivar a chave.

keySize
Int32

O tamanho da chave, em bits, a ser derivada.

rgbIV
Byte[]

O iv (vetor de inicialização) a ser usado para derivar a chave.

Retornos

Byte[]

A chave derivada.

Exceções

CryptographicException

O keySize parâmetro está incorreto.

-ou-

O CSP (provedor de serviços criptográficos) não pode ser adquirido.

-ou-

O algname parâmetro não é um nome de algoritmo válido.

-ou-

O alghashname parâmetro não é um nome de algoritmo de hash válido.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a PasswordDeriveBytes classe.


// Create the key and set it to the Key property
// of the TripleDESCryptoServiceProvider object.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
tdes.Key = pdb.CryptDeriveKey("TripleDES", "SHA1", 192, tdes.IV);


' Create the key and set it to the Key property
' of the TripleDESCryptoServiceProvider object.
' This example uses the SHA1 algorithm.
' Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
tdes.Key = pdb.CryptDeriveKey("TripleDES", "SHA1", 192, tdes.IV)

Comentários

Essa função é um wrapper para a função de API de Criptografia CryptDeriveKey() e destina-se a oferecer interoperabilidade com aplicativos usando a API de Criptografia.

Se o keySize parâmetro for definido como 0 bits, o tamanho da chave padrão para o algoritmo especificado será usado.

Aplica-se a

Confira também