Метод ISCrdEnr::setSigningCertificate

  • Статья

Метод setSigningCertificate задает сертификат подписи (также известный как сертификат агента регистрации).

Перед регистрацией от имени пользователей необходимо выбрать или задать сертификат подписи. Закрытый ключ, связанный с этим сертификатом подписи, используется для подписи запроса PKCS #7. PKCS #7, в свою очередь, содержит запрос пользователя PKCS 10 (подписанный закрытым ключом пользователя).

Синтаксис

HRESULT setSigningCertificate(
  [in] DWORD dwFlags,
  [in] BSTR bstrCertTemplateName
);


SCrdEnr.setSigningCertificate( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName _
)

Параметры

dwFlags [in]

Зарезервировано для последующего использования. Задайте для этого значения нулевое значение.

bstrCertTemplateName [in]

Имя шаблона сертификата для подписи сертификата. Если вы получили сертификат EnrollmentAgent, можно использовать значение EnrollmentAgent.

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

VB

Если метод выполнен успешно, метод возвращает S_OK.

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

Комментарии

Перед регистрацией от имени пользователя необходимо сначала получить сертификат подписи. Сертификат подписи можно получить с помощью оснастки MMC диспетчера сертификатов. Метод setSigningCertificate не получает сертификат подписи, но сообщает элементу управления регистрации смарт-карт, который ранее получил сертификат подписи для использования. Метод setSigningCertificate выполняет поиск последнего сертификата подписи, соответствующего шаблону сертификата, заданного bstrCertTemplateName, в хранилище "My" вызывающего объекта.

Альтернативой setSigningCertificate является ISCrdEnr::setSigningCertificate.

После задания сертификата подписи его имя можно получить, вызвав isCrdEnr::getSigningCertificateName.

Требования

Требование Значение
Минимальная версия клиента
 Ни одна версия не поддерживается
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
DLL
Scrdenrl.dll
IID
 IID_ISCrdEnr определяется как 753988a1-1357-436d-9cf5-f089bd67d64

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

ISCrdEnr

ISCrdEnr::getSigningCertificateName