Метод ISmimeCapability::Initialize (certenroll.h)

Статья
02/23/2024

Метод Initialize инициализирует объект из симметричного идентификатора объекта алгоритма шифрования (OID) и необязательной длины ключа.

Синтаксис

HRESULT Initialize(
  [in] IObjectId *pObjectId,
  [in] LONG      BitCount
);

Параметры

[in] pObjectId

Указатель на интерфейс IObjectId , представляющий OID.

[in] BitCount

Переменная LONG , содержащая битовую длину симметричного ключа.

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

Если функция выполнена успешно, функция возвращает S_OK.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Возвращаемый код или значение	Описание
CERTSRV_E_PROPERTY_EMPTY	Указатель IObjectId имеет значение NULL.

API регистрации сертификатов поддерживает следующие алгоритмы симметричного шифрования. Только алгоритмы RC2 и RC4 имеют переменную длину ключа, которую можно указать.

OID	Длина ключа	Описание
XCN_OID_OIWSEC_desCBC1.3.14.3.2.7	56	Размер ключа алгоритма DES CBC составляет 56 бит. Указывать это значение не нужно.
XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7	168	Размер ключа для алгоритма CBC 3DES составляет 168 бит. Указывать это значение не нужно.
XCN_OID_RSA_RC2CBC1.2.840.113549.3.2	от 40 до 128	RC4 — это алгоритм ключа переменной. Общие значения: 40, 64 и 128 бит.
XCN_OID_RSA_RC41.2.840.113549.3.4	от 40 до 128	RC4 — это алгоритм ключа переменной. Общие значения: 40, 64 и 128 бит.
XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6	168	Размер ключа алгоритма шифрования ключей СТАНДАРТА ШИФРОВАНИЯ MMS (DES) составляет 168 бит. Указывать это значение не нужно.
XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7	128	Размер ключа алгоритма шифрования ключей MMS RC2 составляет 128 бит. Указывать это значение не нужно.
XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2	128	Размер ключа подразумевается идентификатором OID. Указывать это значение не нужно.
XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22	192	Размер ключа подразумевается идентификатором OID. Указывать это значение не нужно.
XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42	256	Размер ключа подразумевается идентификатором OID. Указывать это значение не нужно.
XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5	128	Размер ключа подразумевается идентификатором OID. Указывать это значение не нужно.
XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25	192	Размер ключа подразумевается идентификатором OID. Указывать это значение не нужно.
XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45	256	Размер ключа подразумевается идентификатором OID. Указывать это значение не нужно.

Длина ключа, указанная для алгоритмов RC2 и RC4, должна соответствовать длине ключа, поддерживаемой поставщиком шифрования или поставщиками, используемыми клиентом. Дополнительные сведения см. в разделе ICspInformation. Длину бита можно получить, вызвав свойство BitCount , а можно получить OID алгоритма, вызвав свойство ObjectId .

Требования

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

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

ISmimeCapabilities

ISmimeCapability

IX509ExtensionSmimeCapabilities

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