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

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

  • Статья

Метод Initialize инициализирует свойство из идентификатора запроса сертификата, строки конфигурации центра сертификации (ЦС) и необязательного отображаемого имени сертификата.

Синтаксис

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

Параметры

[in] RequestId

Переменная LONG , содержащая идентификатор запроса сертификата. Идентификатор запроса создается процессом регистрации. Это значение можно получить, вызвав свойство RequestId в интерфейсе IX509Enrollment .

[in] strCADnsName

Переменная BSTR , содержащая DNS-имя ЦС. Это имя в строке конфигурации CADnsName\CAName . Строка конфигурации обычно задается в процессе регистрации. DNS-имя можно получить, вызвав свойство CAConfigString и разделив строку на составляющие части.

[in] strCAName

Переменная BSTR , содержащая общее имя субъекта (CN) ЦС. Это второе имя в строке конфигурации ЦС CADnsName\CAName . Строка конфигурации обычно задается в процессе регистрации. Имя CN можно получить, вызвав свойство CAConfigString и разделив строку на составляющие части.

[in, optional] strFriendlyName

Переменная BSTR , содержащая необязательное отображаемое имя сертификата. Значение по умолчанию — NULL. Это значение обычно устанавливается в процессе регистрации. Его можно получить, вызвав свойство CertificateFriendlyName .

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

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

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

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

Комментарии

Значения, которые можно использовать для инициализации объекта ICertPropertyEnrollment , задаются в процессе регистрации сертификата, когда клиент вызывает метод Enroll для объекта IX509Enrollment . То есть, чтобы получить идентификатор запроса, вызовите свойство RequestId объекта IX509Enrollment . Чтобы получить отображаемое имя сертификата, вызовите свойство CertificateFriendlyName . Чтобы получить различающееся имя и общее имя, вызовите свойство CAConfigString и разделите строку конфигурации на составляющие части.

Вызовите метод SetValueOnCertificate , чтобы связать свойство с сертификатом. Для получения значений, указанных во время инициализации, можно также вызвать следующие свойства:

Требования

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

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

ICertProperty

ICertPropertyEnrollment