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

Статья
08/22/2023

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

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

Синтаксис

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

Параметры

[in] dwTable

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

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

[in] pszContext

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

[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, которая содержит идентификатор удаляемой криптографической функции.

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

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

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

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

Требования

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

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

BCryptAddContextFunction