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