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

Статья
03/14/2023

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

Функция BCryptConfigureContextFunction задает сведения о конфигурации для криптографической функции существующего контекста CNG.

Синтаксис

NTSTATUS BCryptConfigureContextFunction(
  [in] ULONG                          dwTable,
  [in] LPCWSTR                        pszContext,
  [in] ULONG                          dwInterface,
  [in] LPCWSTR                        pszFunction,
  [in] PCRYPT_CONTEXT_FUNCTION_CONFIG pConfig
);

Параметры

[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] pConfig

Адрес структуры CRYPT_CONTEXT_FUNCTION_CONFIG , содержащей сведения о конфигурации новой функции.

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

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

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

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

Требования

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

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

CRYPT_CONTEXT_FUNCTION_CONFIG

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