ECDiffieHellman.DeriveKeyFromHash Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет формирование ключа с использованием указанного хэш-алгоритма.
Перегрузки
| DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName) |
Выполняет формирование ключа с использованием указанного хэш-алгоритма. |
| DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[], Byte[]) |
При реализации в производном классе выполняет формирование ключа с использованием указанного хэш-алгоритма с дополнительными данными, добавленными в начале или конце. |
DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName)
- Исходный код:
- ECDiffieHellman.cs
- Исходный код:
- ECDiffieHellman.cs
- Исходный код:
- ECDiffieHellman.cs
Выполняет формирование ключа с использованием указанного хэш-алгоритма.
public:
cli::array <System::Byte> ^ DeriveKeyFromHash(System::Security::Cryptography::ECDiffieHellmanPublicKey ^ otherPartyPublicKey, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);public byte[] DeriveKeyFromHash (System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);member this.DeriveKeyFromHash : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName -> byte[]Public Function DeriveKeyFromHash (otherPartyPublicKey As ECDiffieHellmanPublicKey, hashAlgorithm As HashAlgorithmName) As Byte()Параметры
- otherPartyPublicKey
- ECDiffieHellmanPublicKey
Открытый ключ другой стороны.
- hashAlgorithm
- HashAlgorithmName
Хэш-алгоритм, используемый для получения материала ключа.
Возвращаемое значение
Хэш общего секрета.
Исключения
Размер кривой, используемой параметром otherPartyPublicKey, отличается от размера кривой из этого ключа.
-или-
В параметре hashAlgorithm не указан хэш.
otherPartyPublicKey имеет значение null.
Кривая, используемая параметром otherPartyPublicKey, отличается от кривой из этого ключа.
-или-
Этот экземпляр представляет только открытый ключ.
Комментарии
Эта перегрузка вызывает метод , DeriveKeyFromHash передавая null в качестве значений в начале и добавлении.
Применяется к
DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[], Byte[])
- Исходный код:
- ECDiffieHellman.cs
- Исходный код:
- ECDiffieHellman.cs
- Исходный код:
- ECDiffieHellman.cs
При реализации в производном классе выполняет формирование ключа с использованием указанного хэш-алгоритма с дополнительными данными, добавленными в начале или конце.
public:
virtual cli::array <System::Byte> ^ DeriveKeyFromHash(System::Security::Cryptography::ECDiffieHellmanPublicKey ^ otherPartyPublicKey, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ secretPrepend, cli::array <System::Byte> ^ secretAppend);public virtual byte[] DeriveKeyFromHash (System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[]? secretPrepend, byte[]? secretAppend);public virtual byte[] DeriveKeyFromHash (System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] secretPrepend, byte[] secretAppend);abstract member DeriveKeyFromHash : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName * byte[] * byte[] -> byte[]
override this.DeriveKeyFromHash : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName * byte[] * byte[] -> byte[]Public Overridable Function DeriveKeyFromHash (otherPartyPublicKey As ECDiffieHellmanPublicKey, hashAlgorithm As HashAlgorithmName, secretPrepend As Byte(), secretAppend As Byte()) As Byte()Параметры
- otherPartyPublicKey
- ECDiffieHellmanPublicKey
Открытый ключ другой стороны.
- hashAlgorithm
- HashAlgorithmName
Хэш-алгоритм, используемый для получения материала ключа.
- secretPrepend
- Byte[]
Значение, добавляемое к производному секрету (в начало) перед хэшированием.
- secretAppend
- Byte[]
Значение, добавляемое к производному секрету перед хэшированием.
Возвращаемое значение
Хэш общего секрета после добавления данных по запросу в начале или конце.
Исключения
Производный класс должен переопределять этот метод.
Размер кривой, используемой параметром otherPartyPublicKey, отличается от размера кривой из этого ключа.
-или-
В параметре hashAlgorithm не указан хэш.
otherPartyPublicKey имеет значение null.
Кривая, используемая параметром otherPartyPublicKey, отличается от кривой из этого ключа.
-или-
Этот экземпляр представляет только открытый ключ.
Комментарии
Этот метод внутренне выполняет соглашение Diffie-Hellman ключа эллиптической кривой для создания общего секрета (z).
Возвращаемое этим методом значение является результатом использования указанного HASH(secretPrepend || z || secretAppend) хэш-алгоритма, где || означает объединение.
Если значение secretPrepend или secretAppend равно null, они обрабатываются как пустые массивы.
