структура CMSG_CTRL_DECRYPT_PARA (wincrypt.h)

  • Статья

Структура CMSG_CTRL_DECRYPT_PARA содержит сведения, используемые для расшифровки сообщения в конверте для получателя транспорта ключа. Эта структура передается в CryptMsgControl , если параметр dwCtrlType CMSG_CTRL_DECRYPT.

Сведения о том, как CryptoAPI поддерживает взаимодействие электронной почты с защищенными и многоцелевыми расширениями электронной почты (S/MIME), см. в разделе Примечания статьи CryptMsgOpenToEncode.

Синтаксис

typedef struct _CMSG_CTRL_DECRYPT_PARA {
  DWORD cbSize;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD dwKeySpec;
  DWORD dwRecipientIndex;
} CMSG_CTRL_DECRYPT_PARA, *PCMSG_CTRL_DECRYPT_PARA;

Члены

cbSize

Размер данной структуры (в байтах).

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

Дескриптор поставщика служб шифрования (CSP). Функция CNG NCryptIsKeyHandle вызывается для определения выбора объединения.

DUMMYUNIONNAME.hNCryptKey

Дескриптор для поставщика служб шифрования CNG (CSP). Функция CNG NCryptIsKeyHandle вызывается для определения выбора объединения. Новые алгоритмы шифрования поддерживаются только в функциях CNG. Функция CNG NCryptTranslateHandle будет вызвана для преобразования варианта CryptoAPI hCryptProv при необходимости. Рекомендуется, чтобы приложения передавали члену hNCryptKey дескриптор CSP CNG, возвращаемый функцией NCryptOpenKey .

dwKeySpec

Используемый закрытый ключ. Этот элемент не используется при использовании элемента hNCryptKey .

Следующие значения dwKeySpec определяются для поставщика по умолчанию.

Значение Значение
AT_KEYEXCHANGE
 Ключи, используемые для шифрования и расшифровки ключей сеанса.
AT_SIGNATURE
 Ключи, используемые для создания и проверки цифровых подписей.
 

Если параметр dwKeySpec равен нулю, используется AT_KEYEXCHANGE по умолчанию.

dwRecipientIndex

Индекс получателя в сообщении, связанном с закрытым ключом hCryptProv .

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть wincrypt.h

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

CryptMsgControl