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

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

  • Статья

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

Синтаксис

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

Параметры

[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.

[in] pszFunction

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

[in] pszProperty

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

[in] cbValue

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

[in] pbValue

Адрес буфера, содержащего новое значение свойства.

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

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

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

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

Комментарии

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

Требования

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