Метод ISmimeCapability::Initialize (certenroll.h)
Метод Initialize инициализирует объект из симметричного идентификатора объекта алгоритма шифрования (OID) и необязательной длины ключа.
Синтаксис
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
Параметры
[in] pObjectId
Указатель на интерфейс IObjectId , представляющий OID.
[in] BitCount
Переменная LONG , содержащая битовую длину симметричного ключа.
Возвращаемое значение
Если функция выполнена успешно, функция возвращает S_OK.
Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
| Возвращаемый код или значение | Описание |
|---|---|
|
Указатель 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 |