Метод IX509CertificateRequestCmc::InitializeFromInnerRequestTemplateName (certenroll.h)

  • Статья

Метод InitializeFromInnerRequestTemplateName инициализирует запрос сертификата из внутреннего объекта запроса и шаблона.

Синтаксис

HRESULT InitializeFromInnerRequestTemplateName(
  [in] IX509CertificateRequest *pInnerRequest,
  [in] BSTR                    strTemplateName
);

Параметры

[in] pInnerRequest

Указатель на интерфейс IX509CertificateRequest , представляющий объект внутреннего запроса. Это может быть запрос PKCS #10 или CMC.

[in] strTemplateName

Переменная BSTR , содержащая общее имя (CN) шаблона в том виде, в котором оно отображается в Active Directory, или идентификатор десятичного объекта с точками.

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

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

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

Возвращаемый код/значение Описание
CRYPT_E_INVALID_MSG_TYPE
 Объект запроса, передаваемый параметру pInnerRequest , должен быть PKCS #10 или запросом CMC.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Объект запроса уже инициализирован.

Комментарии

Указав шаблон, можно добавить сведения во внешний объект запроса, который может не содержаться во внутреннем запросе. Например, если внутренний запрос не содержит необходимых расширений, можно указать шаблон, который делает.

Метод InitializeFromInnerRequestTemplateName :

  • Создает пустую коллекцию ICryptAttributes .
  • Создает пустую коллекцию IX509NameValuePairs .
  • Создает пустую коллекцию IX509Extensions .
  • Создает коллекцию IObjectIds для критически важных расширений и добавляет идентификаторы объектов XCN_OID_KEY_USAGE и XCN_OID_BASIC_CONSTRAINTS2.
  • Создает пустую коллекцию IObjectIds идентификаторов OID для подавления из объекта запроса.
  • Создает пустую коллекцию ISignerCertificates .
  • Извлекает флаги закрытого ключа из шаблона.
  • Задает свойство ArchivePrivateKey , если это требуется для флагов или параметров шаблона.
  • Извлекает алгоритм шифрования из шаблона, если он указан, и задает свойство EncryptionAlgorithm .
  • По возможности задает свойство EncryptionStrength .

Требования

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

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

IX509CertificateRequestCmc