КриптоПро CSP  

CPHashSessionKey

Функция CPHashSessionKey() передаёт криптографический ключ указанному объекту функции хэширования. Это позволяет хэшировать ключи сессии без передачи ключа приложению.

BOOL WINAPI CPHashSessionKey(
  HCRYPTPROV hProv,
  HCRYPTHASH hHash,
  HCRYPTKEY hKey,
  DWORD dwFlags
);

Аргументы

hProv
[in] Дескриптор криптопровайдера. Получается при помощи функции CPAcquireContext().
hHash
[in] Дескриптор объекта функции хэширования. Приложение получает этот дескриптор, используя функцию CPCreateHash().
hKey
[in] Дескриптор хэшируемого ключа сессии. Хэш типа CALG_FITTINGKEY_HASH собирает ключи в единый ключ, создаваемый функцией CPDeriveKey().
dwFlags
[in] Значение CRYPT_LITTLE_ENDIAN соответствует хэшированию ключа в порядке байт, определяемым ГОСТ 28147-89 или ГОСТ Р 34.12-2015 в зависимости от типа ключа, нулевое значение соответствует хэшированию в обратном порядке байт ключа.

Возвращаемые значения

При успешном завершении функция возвращает TRUE, в противном случае возвращается FALSE. Если возвращается FALSE, соответствующий код ошибки (см. таблицу) может быть получен через функцию GetLastError().
Коды возвратаОписание
NTE_BAD_HASHДескриптор хэша ошибочен.
NTE_BAD_ALGIDПараметр AlgId определяет алгоритм, который не поддерживается криптопровайдером.
NTE_BAD_HASH_STATEБыла сделана попытка добавить данные к объекту функции хэширования, который уже отмечен как "закрытый".
NTE_BAD_KEYТип хэшируемого ключа не соответствует ALG_TYPE_BLOCK.

Примечания

Функция CPHashSessionKey() добавляет к объекту функции хэширования только значение сессионного ключа hKey. Приложение должно самостоятельно добавлять к этому объекту дополнительные величины, такие как стартовый вектор шифрования и т.п.

Использование функции с dwFlags равным 0 не рекомендуется - поведение не определено.

Требования:

AIX: 5/6/7 или выше.
FreeBSD: 7/8/9 или выше.
Linux: LSB 3.1 (RHEL 4, SuSE 10) или выше.
Solaris: 10 или выше.
Mac OSX: 10.7/8 или выше.
iOS: 6/7 или выше.
Windows 2000 или выше: Необходимо Windows 2000 SP4 или старше с Internet Explorer 6.0 или старше.
Файл описания: Прототип описан в файле wincsp.h.
Ядро ОС: Вместо неё используется аналогичная функция CPCHashSessionKey .

См. также

CPCreateHash() ,CPGenKey() ,CPHashData() ,CPHashSessionKey в MS CSP World Wide Web link ,CryptHashSessionKey в MS CryptoAPI 2.0 World Wide Web link