Крипто-Про CSP

CPHashSessionKey

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

установленного в реестре флага равно

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

Аргументы

hProv
[in] Дескриптор криптопровайдера. Получается при помощи функции CPAcquireContext().
hHash
[in] Дескриптор объекта функции хеширования. Приложение получает этот дескриптор, используя функцию CPCreateHash().
hKey
[in] Дескриптор хешируемого ключа сессии.
dwFlags
[in] Параметр зарезервирован для будущего использования и должен быть нулевым.

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

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

Примечания

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

Требования:

Windows 2000/XP/2003: Необходимо Windows 2000 SP4 или старше с Internet Explorer 6.0 или старше.
Windows NT/95/98/ME: CSP 3.0 не поддерживает (см. КриптоПро CSP 2.0 World Wide Web link ).
Solaris: 9 Update 4 или выше.
FreeBSD: FreeBSD 5.2 или выше
Linux: RedHat 7.3, RedHad 9.0.
Файл описания: Прототип описан в файле wincsp.h.
Ядро Windows NT: IRQL < DISPATCH_LEVEL

См. также:

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

Крипто-Про CSP Версия: 3.0 Сборка 3293
Что Вы думаете по поводу данной статьи?
Закажите CD c Крипто-Про CSP