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

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

  • Статья

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

Функция BCryptCreateContext создает новый контекст конфигурации CNG.

Синтаксис

NTSTATUS BCryptCreateContext(
  [in]           ULONG                 dwTable,
  [in]           LPCWSTR               pszContext,
  [in, optional] PCRYPT_CONTEXT_CONFIG pConfig
);

Параметры

[in] dwTable

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

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

[in] pszContext

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

[in, optional] pConfig

Указатель на структуру CRYPT_CONTEXT_CONFIG , которая содержит дополнительные данные конфигурации для нового контекста. Этот параметр может иметь значение NULL , если он не требуется.

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

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

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

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

Комментарии

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

Требования

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