SP800108HmacCounterKdf.DeriveBytes 方法

参考

定义

命名空间:: System.Security.Cryptography

程序集:: System.Security.Cryptography.dll

程序集:: Microsoft.Bcl.Cryptography.dll

包:: Microsoft.Bcl.Cryptography v9.0.0-rc.2.24473.5

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

DeriveBytes(Byte[], HashAlgorithmName, Byte[], Byte[], Int32)	派生指定长度的键。
DeriveBytes(Byte[], HashAlgorithmName, String, String, Int32)	派生指定长度的键。
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	派生指定长度的键。
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>)	使用派生密钥填充缓冲区。
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32)	派生指定长度的键。
DeriveBytes(ReadOnlySpan<Byte>, HashAlgorithmName, ReadOnlySpan<Char>, ReadOnlySpan<Char>, Span<Byte>)	使用派生密钥填充缓冲区。

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

Source:: SP800108HmacCounterKdf.cs

Source:: SP800108HmacCounterKdf.cs

派生指定长度的键。

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()

参数

key: Byte[]

密钥派生密钥。

hashAlgorithm: HashAlgorithmName

HMAC 算法。

label: Byte[]

标识派生密钥用途的标签。

context: Byte[]

包含与派生密钥相关的信息的上下文。

derivedKeyLengthInBytes: Int32

派生密钥的长度（以字节为单位）。

Byte[]

包含派生密钥的数组。

例外

ArgumentNullException

key null。

-或-

label null。

-或-

context null。

-或-

hashAlgorithm 有一个 null的 Name。

ArgumentException

hashAlgorithm 有一个空 Name。

ArgumentOutOfRangeException

derivedKeyLengthInBytes 为负数或大于可派生的最大字节数。

CryptographicException

hashAlgorithm 不是已知或受支持的哈希算法。

PlatformNotSupportedException

当前平台没有 HMAC 支持的实现。

适用于

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

Source:: SP800108HmacCounterKdf.cs

Source:: SP800108HmacCounterKdf.cs

派生指定长度的键。

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()

参数

key: Byte[]

密钥派生密钥。

hashAlgorithm: HashAlgorithmName

HMAC 算法。

label: String

标识派生密钥用途的标签。

context: String

包含与派生密钥相关的信息的上下文。

derivedKeyLengthInBytes: Int32

派生密钥的长度（以字节为单位）。

Byte[]

包含派生密钥的数组。

例外

ArgumentNullException

key null。

-或-

label null。

-或-

context null。

-或-

hashAlgorithm 有一个 null的 Name。

ArgumentException

hashAlgorithm 有一个空 Name。

ArgumentOutOfRangeException

derivedKeyLengthInBytes 为负数或大于可派生的最大字节数。

CryptographicException

hashAlgorithm 不是已知或受支持的哈希算法。

EncoderFallbackException

label 或 context 包含无法转换为 UTF-8 的文本。

PlatformNotSupportedException

当前平台没有 HMAC 支持的实现。

注解

label 和 context 将使用 UTF-8 编码转换为字节。对于其他编码，请使用所需的编码执行转换，并使用接受标签和上下文作为字节序列的重载。

适用于

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

Source:: SP800108HmacCounterKdf.cs

Source:: SP800108HmacCounterKdf.cs

派生指定长度的键。

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()

参数

key: ReadOnlySpan<Byte>

密钥派生密钥。

hashAlgorithm: HashAlgorithmName

HMAC 算法。

label: ReadOnlySpan<Byte>

标识派生密钥用途的标签。

context: ReadOnlySpan<Byte>

包含与派生密钥相关的信息的上下文。

derivedKeyLengthInBytes: Int32

派生密钥的长度（以字节为单位）。

Byte[]

包含派生密钥的数组。

例外

ArgumentNullException

hashAlgorithm 有一个 null的 Name。

ArgumentException

hashAlgorithm 有一个空 Name。

ArgumentOutOfRangeException

derivedKeyLengthInBytes 为负数或大于可派生的最大字节数。

CryptographicException

hashAlgorithm 不是已知或受支持的哈希算法。

PlatformNotSupportedException

当前平台没有 HMAC 支持的实现。

适用于

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

Source:: SP800108HmacCounterKdf.cs

Source:: SP800108HmacCounterKdf.cs

使用派生密钥填充缓冲区。

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))

参数

key: ReadOnlySpan<Byte>

密钥派生密钥。

hashAlgorithm: HashAlgorithmName

HMAC 算法。

label: ReadOnlySpan<Byte>

标识派生密钥用途的标签。

context: ReadOnlySpan<Byte>

包含与派生密钥相关的信息的上下文。

destination: Span<Byte>

将接收派生密钥的缓冲区。

例外

ArgumentNullException

hashAlgorithm 有一个 null的 Name。

ArgumentException

hashAlgorithm 有一个空 Name。

ArgumentOutOfRangeException

destination 大于可派生的最大字节数。

CryptographicException

hashAlgorithm 不是已知或受支持的哈希算法。

PlatformNotSupportedException

当前平台没有 HMAC 支持的实现。

适用于

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

Source:: SP800108HmacCounterKdf.cs

Source:: SP800108HmacCounterKdf.cs

派生指定长度的键。

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()

参数

key: ReadOnlySpan<Byte>

密钥派生密钥。

hashAlgorithm: HashAlgorithmName

HMAC 算法。

label: ReadOnlySpan<Char>

标识派生密钥用途的标签。

context: ReadOnlySpan<Char>

包含与派生密钥相关的信息的上下文。

derivedKeyLengthInBytes: Int32

派生密钥的长度（以字节为单位）。

Byte[]

包含派生密钥的数组。

例外

ArgumentNullException

hashAlgorithm 有一个 null的 Name。

ArgumentException

hashAlgorithm 有一个空 Name。

ArgumentOutOfRangeException

derivedKeyLengthInBytes 为负数或大于可派生的最大字节数。

CryptographicException

hashAlgorithm 不是已知或受支持的哈希算法。

EncoderFallbackException

label 或 context 包含无法转换为 UTF-8 的文本。

PlatformNotSupportedException

当前平台没有 HMAC 支持的实现。

注解

label 和 context 将使用 UTF-8 编码转换为字节。对于其他编码，请使用所需的编码执行转换，并使用接受标签和上下文作为字节序列的重载。

适用于

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

Source:: SP800108HmacCounterKdf.cs

Source:: SP800108HmacCounterKdf.cs

使用派生密钥填充缓冲区。

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))