DWORD CPCAPI CPCHashData( HCRYPTMODULE hCSP, HCRYPTPROV hProv, HCRYPTHASH hHash, CONST BYTE * pbData, DWORD dwDataLen, DWORD dwFlags );
Аргументы
- hCSP
- [in] Указатель на таблицу функций криптопровайдера. Получается при помощи функции CPCCreateProvider()
- hProv
- [in] Дескриптор криптопровайдера. Получается при помощи функции CPCAcquireContext().
- hHash
- [in] Дескриптор объекта функции хэширования. Приложение получает этот дескриптор, используя функцию CPCCreateHash().
- pbData
- [in] Если значение dwFlags нулевое, указатель на буфер, содержащий данные для хэширования. Если установлен флаг CP_HASH_DATA_IOVEC указатель на массив структур CSP_iovec. См. Вектор ввода вывода .
- dwDataLen
- [in] Если значение dwFlags нулевое, число байтов хэшируемых данных. Если установлен флаг CP_HASH_DATA_IOVEC, число элементов массива CSP_iovec.
- dwFlags
- [in] Значения флагов. Параметр определяет способ обработки фрагмента данных в потоке. Нулевое значение соответствует хэшированию фрагмента данных потока, флаг CP_HASH_DATA_IOVEC соответствует обработке данных в форме вектора ввода/вывода. См. Вектор ввода вывода .
Возвращаемые значения
При успешном завершении функция возвращает 0 (S_OK), в противном случае возвращается соответствующий код ошибки (см. таблицу).| Коды возврата | Описание |
|---|---|
| ERROR_INVALID_PARAMETER | Один из параметров содержит некорректное значение. Чаще всего это некорректный указатель. |
| NTE_BAD_ALGID | Указанный объект хэширования не поддерживает данную операцию. |
| NTE_BAD_HASH | Дескриптор хэша ошибочен. |
| NTE_BAD_HASH_STATE | Была сделана попытка добавить данные к объекту функции хэширования, который уже отмечен как "закрытый". |
| NTE_BAD_KEY | Используется алгоритм хэширования (CALG_G28147_IMIT, CALG_GR3413_2015_M_IMIT, CALG_GR3413_2015_K_IMIT), но сессионный ключ удалён прежде, чем действие хэширования завершено, или превышена допустимая нагрузка на ключ. |
| NTE_BAD_FLAGS | Величина dwFlags имеет значение, отличное от нулевого либо от CP_HASH_DATA_IOVEC. |
| NTE_BAD_LEN | Величина dwDataLen при установленном флаге CP_HASH_DATA_IOVEC имеет значение, превосходящее CSP_UIO_MAXIOV. |
| NTE_FAIL | Нарушение целостности ключей в ОЗУ. |
| SCARD_W_CANCELLED_BY_USER | Операция хэширования отменена пользователем. |
| ERROR_MESSAGE_EXCEEDS_MAX_SIZE | Попытка хэширования слишком большого блока данных. |
Требования:
Ядро AIX: 6/7.
Ядро FreeBSD: 11/12.
Ядро Linux: 2.6.x и выше.
Ядро Solaris: 10/11.
Ядро Windows: 7/8/8.1/10, Server 2008/2008R2/2012/2012R2/2016/2019.
См. также
CPCCreateHash() ,CPCHashSessionKey() ,CPHashData в MS CSP 
,CryptHashData в MS CryptoAPI 2.0