SP800108HmacCounterKdf.DeriveBytes Método

Referência

Definição

Namespace:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

DeriveBytes(Byte[], HashAlgorithmName, Byte[], Byte[], Int32)	Deriva uma chave de um comprimento especificado.
DeriveBytes(Byte[], HashAlgorithmName, String, String, Int32)	Deriva uma chave de um comprimento especificado.
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	Deriva uma chave de um comprimento especificado.
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>)	Preenche um buffer com uma chave derivada.
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32)	Deriva uma chave de um comprimento especificado.
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Byte>)	Preenche um buffer com uma chave derivada.

DeriveBytes(Byte[], HashAlgorithmName, Byte[], Byte[], Int32)

Origem:: SP800108HmacCounterKdf.cs

Origem:: SP800108HmacCounterKdf.cs

Deriva uma chave de um comprimento especificado.

public:
 static cli::array <System::Byte> ^ DeriveBytes(cli::array <System::Byte> ^ key, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ label, cli::array <System::Byte> ^ context, int derivedKeyLengthInBytes);

public static byte[] DeriveBytes (byte[] key, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] label, byte[] context, int derivedKeyLengthInBytes);

static member DeriveBytes : byte[] * System.Security.Cryptography.HashAlgorithmName * byte[] * byte[] * int -> byte[]

Public Shared Function DeriveBytes (key As Byte(), hashAlgorithm As HashAlgorithmName, label As Byte(), context As Byte(), derivedKeyLengthInBytes As Integer) As Byte()

Parâmetros

key: Byte[]

A chave de derivação de chave.

hashAlgorithm: HashAlgorithmName

O algoritmo HMAC.

label: Byte[]

O rótulo que identifica a finalidade da chave derivada.

context: Byte[]

O contexto que contém informações relacionadas à chave derivada.

derivedKeyLengthInBytes: Int32

O comprimento da chave derivada, em bytes.

Retornos

Byte[]

Uma matriz que contém a chave derivada.

Exceções

ArgumentNullException

key é null.

- ou -

label é null.

- ou -

context é null.

- ou -

hashAlgorithm tem um Name que é null.

ArgumentException

hashAlgorithm tem um Name que está vazio.

ArgumentOutOfRangeException

derivedKeyLengthInBytes é negativo ou maior que o número máximo de bytes que podem ser derivados.

CryptographicException

hashAlgorithm não é um algoritmo de hash conhecido ou com suporte.

PlatformNotSupportedException

A plataforma atual não tem uma implementação com suporte do HMAC.

Aplica-se a

DeriveBytes(Byte[], HashAlgorithmName, String, String, Int32)

Origem:: SP800108HmacCounterKdf.cs

Origem:: SP800108HmacCounterKdf.cs

Deriva uma chave de um comprimento especificado.

public:
 static cli::array <System::Byte> ^ DeriveBytes(cli::array <System::Byte> ^ key, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, System::String ^ label, System::String ^ context, int derivedKeyLengthInBytes);

public static byte[] DeriveBytes (byte[] key, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, string label, string context, int derivedKeyLengthInBytes);

static member DeriveBytes : byte[] * System.Security.Cryptography.HashAlgorithmName * string * string * int -> byte[]

Public Shared Function DeriveBytes (key As Byte(), hashAlgorithm As HashAlgorithmName, label As String, context As String, derivedKeyLengthInBytes As Integer) As Byte()

Parâmetros

key: Byte[]

A chave de derivação de chave.

hashAlgorithm: HashAlgorithmName

O algoritmo HMAC.

label: String

O rótulo que identifica a finalidade da chave derivada.

context: String

O contexto que contém informações relacionadas à chave derivada.

derivedKeyLengthInBytes: Int32

O comprimento da chave derivada, em bytes.

Retornos

Byte[]

Uma matriz que contém a chave derivada.

Exceções

ArgumentNullException

key é null.

- ou -

label é null.

- ou -

context é null.

- ou -

hashAlgorithm tem um Name que é null.

ArgumentException

hashAlgorithm tem um Name que está vazio.

ArgumentOutOfRangeException

derivedKeyLengthInBytes é negativo ou maior que o número máximo de bytes que podem ser derivados.

CryptographicException

hashAlgorithm não é um algoritmo de hash conhecido ou com suporte.

EncoderFallbackException

label ou context contém texto que não pode ser convertido em UTF-8.

PlatformNotSupportedException

A plataforma atual não tem uma implementação com suporte do HMAC.

Comentários

label e context serão convertidos em bytes usando a codificação UTF-8. para outras codificações, execute a conversão usando a codificação desejada e use uma sobrecarga que aceita o rótulo e o contexto como uma sequência de bytes.

Aplica-se a

DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)

Origem:: SP800108HmacCounterKdf.cs

Origem:: SP800108HmacCounterKdf.cs

Deriva uma chave de um comprimento especificado.

public:
 static cli::array <System::Byte> ^ DeriveBytes(ReadOnlySpan<System::Byte> key, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, ReadOnlySpan<System::Byte> label, ReadOnlySpan<System::Byte> context, int derivedKeyLengthInBytes);

public static byte[] DeriveBytes (ReadOnlySpan<byte> key, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> label, ReadOnlySpan<byte> context, int derivedKeyLengthInBytes);

static member DeriveBytes : ReadOnlySpan<byte> * System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> byte[]

Public Shared Function DeriveBytes (key As ReadOnlySpan(Of Byte), hashAlgorithm As HashAlgorithmName, label As ReadOnlySpan(Of Byte), context As ReadOnlySpan(Of Byte), derivedKeyLengthInBytes As Integer) As Byte()

Parâmetros

key: ReadOnlySpan<Byte>

A chave de derivação de chave.

hashAlgorithm: HashAlgorithmName

O algoritmo HMAC.

label: ReadOnlySpan<Byte>

O rótulo que identifica a finalidade da chave derivada.

context: ReadOnlySpan<Byte>

O contexto que contém informações relacionadas à chave derivada.

derivedKeyLengthInBytes: Int32

O comprimento da chave derivada, em bytes.

Retornos

Byte[]

Uma matriz que contém a chave derivada.

Exceções

ArgumentNullException

hashAlgorithm tem um Name que é null.

ArgumentException

hashAlgorithm tem um Name que está vazio.

ArgumentOutOfRangeException

derivedKeyLengthInBytes é negativo ou maior que o número máximo de bytes que podem ser derivados.

CryptographicException

hashAlgorithm não é um algoritmo de hash conhecido ou com suporte.

PlatformNotSupportedException

A plataforma atual não tem uma implementação com suporte do HMAC.

Aplica-se a

DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>)

Origem:: SP800108HmacCounterKdf.cs

Origem:: SP800108HmacCounterKdf.cs

Preenche um buffer com uma chave derivada.

public:
 static void DeriveBytes(ReadOnlySpan<System::Byte> key, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, ReadOnlySpan<System::Byte> label, ReadOnlySpan<System::Byte> context, Span<System::Byte> destination);

public static void DeriveBytes (ReadOnlySpan<byte> key, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> label, ReadOnlySpan<byte> context, Span<byte> destination);

static member DeriveBytes : ReadOnlySpan<byte> * System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> * ReadOnlySpan<byte> * Span<byte> -> unit

Public Shared Sub DeriveBytes (key As ReadOnlySpan(Of Byte), hashAlgorithm As HashAlgorithmName, label As ReadOnlySpan(Of Byte), context As ReadOnlySpan(Of Byte), destination As Span(Of Byte))

Parâmetros

key: ReadOnlySpan<Byte>

A chave de derivação de chave.

hashAlgorithm: HashAlgorithmName

O algoritmo HMAC.

label: ReadOnlySpan<Byte>

O rótulo que identifica a finalidade da chave derivada.

context: ReadOnlySpan<Byte>

O contexto que contém informações relacionadas à chave derivada.

destination: Span<Byte>

O buffer que receberá a chave derivada.

Exceções

ArgumentNullException

hashAlgorithm tem um Name que é null.

ArgumentException

hashAlgorithm tem um Name que está vazio.

ArgumentOutOfRangeException

destination é maior que o número máximo de bytes que podem ser derivados.

CryptographicException

hashAlgorithm não é um algoritmo de hash conhecido ou com suporte.

PlatformNotSupportedException

A plataforma atual não tem uma implementação com suporte do HMAC.

Aplica-se a

DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32)

Origem:: SP800108HmacCounterKdf.cs

Origem:: SP800108HmacCounterKdf.cs

Deriva uma chave de um comprimento especificado.

public:
 static cli::array <System::Byte> ^ DeriveBytes(ReadOnlySpan<System::Byte> key, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, ReadOnlySpan<char> label, ReadOnlySpan<char> context, int derivedKeyLengthInBytes);

public static byte[] DeriveBytes (ReadOnlySpan<byte> key, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<char> label, ReadOnlySpan<char> context, int derivedKeyLengthInBytes);

static member DeriveBytes : ReadOnlySpan<byte> * System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<char> * ReadOnlySpan<char> * int -> byte[]

Public Shared Function DeriveBytes (key As ReadOnlySpan(Of Byte), hashAlgorithm As HashAlgorithmName, label As ReadOnlySpan(Of Char), context As ReadOnlySpan(Of Char), derivedKeyLengthInBytes As Integer) As Byte()

Parâmetros

key: ReadOnlySpan<Byte>

A chave de derivação de chave.

hashAlgorithm: HashAlgorithmName

O algoritmo HMAC.

label: ReadOnlySpan<Char>

O rótulo que identifica a finalidade da chave derivada.

context: ReadOnlySpan<Char>

O contexto que contém informações relacionadas à chave derivada.

derivedKeyLengthInBytes: Int32

O comprimento da chave derivada, em bytes.

Retornos

Byte[]

Uma matriz que contém a chave derivada.

Exceções

ArgumentNullException

hashAlgorithm tem um Name que é null.

ArgumentException

hashAlgorithm tem um Name que está vazio.

ArgumentOutOfRangeException

derivedKeyLengthInBytes é negativo ou maior que o número máximo de bytes que podem ser derivados.

CryptographicException

hashAlgorithm não é um algoritmo de hash conhecido ou com suporte.

EncoderFallbackException

label ou context contém texto que não pode ser convertido em UTF-8.

PlatformNotSupportedException

A plataforma atual não tem uma implementação com suporte do HMAC.

Comentários

Aplica-se a

DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Byte>)

Origem:: SP800108HmacCounterKdf.cs

Origem:: SP800108HmacCounterKdf.cs

Preenche um buffer com uma chave derivada.

public:
 static void DeriveBytes(ReadOnlySpan<System::Byte> key, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, ReadOnlySpan<char> label, ReadOnlySpan<char> context, Span<System::Byte> destination);

public static void DeriveBytes (ReadOnlySpan<byte> key, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<char> label, ReadOnlySpan<char> context, Span<byte> destination);

static member DeriveBytes : ReadOnlySpan<byte> * System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<char> * ReadOnlySpan<char> * Span<byte> -> unit

Public Shared Sub DeriveBytes (key As ReadOnlySpan(Of Byte), hashAlgorithm As HashAlgorithmName, label As ReadOnlySpan(Of Char), context As ReadOnlySpan(Of Char), destination As Span(Of Byte))