структура SecPkgContext_KeyInfoA (sspi.h)

Статья
11/20/2024

Структура SecPkgContext_KeyInfo содержит сведения о ключах сеансов , используемых в контексте безопасности. Функция QueryContextAttributes (General) использует эту структуру.

Приложения, использующие поставщик поддержки безопасности Schannel (SSP), не должны использовать структуру SecPkgContext_KeyInfo. Вместо этого используйте структуру SecPkgContext_ConnectionInfo.

Синтаксис

typedef struct _SecPkgContext_KeyInfoA {
  SEC_CHAR      *sSignatureAlgorithmName;
  SEC_CHAR      *sEncryptAlgorithmName;
  unsigned long KeySize;
  unsigned long SignatureAlgorithm;
  unsigned long EncryptAlgorithm;
} SecPkgContext_KeyInfoA, *PSecPkgContext_KeyInfoA;

Члены

sSignatureAlgorithmName

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

sEncryptAlgorithmName

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

KeySize

Указывает эффективную длину ключа в битах для ключа сеанса. Обычно это 40, 56 или 128 битов.

SignatureAlgorithm

Указывает идентификатор алгоритма (ALG_ID), используемый для создания подписей, если он доступен.

EncryptAlgorithm

Указывает идентификатор алгоритма (ALG_ID), используемый для шифрования сообщений. Зарезервировано для дальнейшего использования.

Замечания

Заметка

Заголовок sspi.h определяет SecPkgContext_KeyInfo как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	sspi.h (include Security.h)

См. также

QueryContextAttributes (общие)

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