Поделиться через

Функция BCryptAddContextFunction (bcrypt.h)

  • Статья

[BCryptAddContextFunction доступен для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Функция BCryptAddContextFunction добавляет криптографическую функцию в список функций, поддерживаемых существующим контекстом CNG.

Синтаксис

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

Параметры

[in] dwTable

Определяет таблицу конфигурации, в которую существует контекст. Это может быть одно из следующих значений.

Значение Значение
CRYPT_LOCAL
 Контекст существует в таблице конфигурации локального компьютера.
CRYPT_DOMAIN
 Это значение недоступно для использования.

[in] pszContext

Указатель на строку Юникода, завершающуюся значением NULL, которая содержит идентификатор контекста, в который добавляется функция.

[in] dwInterface

Определяет криптографический интерфейс, в который добавляется функция. Это может быть одно из следующих значений.

Значение Значение
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 Добавьте функцию в список асимметричных функций шифрования.
BCRYPT_CIPHER_INTERFACE
 Добавьте функцию в список функций шифра.
BCRYPT_HASH_INTERFACE
 Добавьте функцию в список хэш-функций.
BCRYPT_RNG_INTERFACE
 Добавьте функцию в список функций генератора случайных чисел.
BCRYPT_SECRET_AGREEMENT_INTERFACE
 Добавьте функцию в список функций секретного соглашения.
BCRYPT_SIGNATURE_INTERFACE
 Добавьте функцию в список функций подписи.
NCRYPT_KEY_STORAGE_INTERFACE
 Добавьте функцию в список функций хранилища ключей.
NCRYPT_SCHANNEL_INTERFACE
 Добавьте функцию в список функций Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE
 Добавьте функцию в список наборов подписей, которые Schannel будет принимать для TLS 1.2.

Windows Vista и Windows Server 2008: Это значение не поддерживается.

[in] pszFunction

Указатель на строку Юникода, завершающуюся значением NULL, которая содержит идентификатор добавляемой криптографической функции.

[in] dwPosition

Указывает позицию в списке, в которую вставляется эта функция. Функция вставляется в эту позицию перед любыми существующими функциями. Значение CRYPT_PRIORITY_TOP используется для вставки функции в начало списка. Значение CRYPT_PRIORITY_BOTTOM используется для вставки функции в конец списка.

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

Возвращает код состояния, указывающий на успешное или неудачное выполнение функции.

Возможные коды возврата включают, помимо прочего, следующие.

Код возврата Описание
STATUS_SUCCESS
 Функция выполнена успешно.
STATUS_INVALID_PARAMETER
 Один или несколько параметров недопустимы.
STATUS_NO_MEMORY
 Произошел сбой выделения памяти.
STATUS_NOT_FOUND
 Не удалось найти контекст.

Комментарии

Если добавленная функция уже находится в списке, она будет удалена и вставлена в новую позицию.

BCryptAddContextFunction можно вызывать только в пользовательском режиме.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header bcrypt.h
Библиотека Bcrypt.lib
DLL Bcrypt.dll

См. также раздел

BCryptRemoveContextFunction