Share via

Метод IEnroll4::createRequestWStr (xenroll.h)

  • Статья

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

Метод createRequestWStr создает запрос на сертификат в формате PKCS #10, PKCS #7 или полное управление сертификатами через CMS (CMC) и сохраняет его в большом двоичном объекте. Этот метод был впервые определен в интерфейсе IEnroll4 .

Синтаксис

HRESULT createRequestWStr(
  [in]  LONG             Flags,
  [in]  LPCWSTR          pwszDNName,
  [in]  LPCWSTR          pwszUsage,
  [out] PCRYPT_DATA_BLOB pblobRequest
);

Параметры

[in] Flags

Значение, указывающее тип создаваемого запроса на сертификат. Укажите одно из следующих значений.

Значение Значение
XECR_CMC
 Полный CMC
XECR_PKCS10_V1_5
 PKCS 10
XECR_PKCS10_V2_0
 PKCS 10 версии 2
XECR_PKCS7
 PKCS 7

[in] pwszDNName

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

[in] pwszUsage

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

[out] pblobRequest

Указатель на структуру CRYPT_DATA_BLOB , получающую запрос.

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

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

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

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

Требования

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

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

IEnroll4