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

Метод IEnroll::createPKCS10WStr (xenroll.h)

  • Статья

[Этот метод больше недоступен для использования в Windows Server 2008 и Windows Vista.]

Метод createPKCS10WStr создает запрос сертификата PKCS #10 в кодировке base64. Этот метод был впервые определен в интерфейсе IEnroll .

Этот запрос на сертификат PKCS #10 в кодировке Base64 (в форме BSTR ) можно отправить в центр сертификации , чтобы запросить выдачу сертификата физическому или юридическому лицу, сведения которого в нем содержатся.

Синтаксис

HRESULT createPKCS10WStr(
  [in]  LPCWSTR          DNName,
  [in]  LPCWSTR          Usage,
  [out] PCRYPT_DATA_BLOB pPkcs10Blob
);

Параметры

[in] DNName

Строка Юникода с символом NULL, содержащая различающееся имя (DN) сущности, для которой выполняется запрос. В этом параметре имя DN должно соответствовать соглашению об именовании X.500 . Например, "CN=User, O=Microsoft". Если двухбуквенный префикс не существует, вместо него можно указать идентификатор объекта (OID).

[in] Usage

Строка Юникода, заканчивающаяся нулевым символом, которая содержит идентификатор идентификатора, описывающий назначение создаваемого сертификата. Например, индивидуальный или коммерческий сертификат Authenticode или проверка подлинности клиента. Можно также указать несколько идентификаторов OID, разделенных запятой.

OID передается в запрос PKCS #10. Для общей расширяемости и простоты понимания элемент управления не пытается понять конкретные целевые идентификаторы OID. Таким образом, если указать идентификатор проверки подлинности клиента, созданный ключ по-прежнему будет ключом подписи, а не ключом обмена.

[out] pPkcs10Blob

Указатель на CRYPT_DATA_BLOB , получающий запрос сертификата PKCS10 в кодировке base64.

Завершив использование этой памяти, освободите ее, передав элемент pbData этой структуры в функцию CoTaskMemFree .

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

Если метод завершается успешно, метод возвращает S_OK, а pPkcs10Blob содержит запрос PKCS #10 в кодировке Base64, который можно отправить непосредственно на веб-сервер для обработки.

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

Комментарии

По умолчанию используется базовый поставщик шифрования Майкрософт, PROV_RSA_FULL является типом поставщика, создается ключ подписи и создается уникальный набор ключей.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header xenroll.h
Библиотека Uuid.lib
DLL Xenroll.dll

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

IEnroll