IEnroll4::createRequestWStr 方法 (xenroll.h)

[此方法在 Windows Server 2008 和 Windows Vista 中不再可用。]

createRequestWStr 方法通过 CMS 创建 PKCS #10、PKCS #7 或完整的证书管理, (CMC) 格式化证书请求并将其存储在 BLOB 中。 此方法首先在 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 结尾的 Unicode 字符串的指针,该字符串包含发出请求的实体的可分辨名称 (DN) 。 DN 名称必须遵循 X.500 命名约定,例如“CN=User,O=Microsoft”。 如果不存在双字母前缀,可以改为提供 OID) (对象标识符。 此参数可以为 NULL

[in] pwszUsage

指向以 null 结尾的 Unicode 字符串的指针,该字符串包含描述所生成证书的用途的 OID,例如,个人或商业验证码证书或客户端身份验证。 还可以指定多个以逗号分隔的 OID。

[out] pblobRequest

指向接收请求 的CRYPT_DATA_BLOB 结构的指针。

使用此内存后,通过将此结构的 pbData 成员传递给 CoTaskMemFree 函数来释放它。

返回值

如果该方法成功,该方法将返回S_OK。

如果方法失败,它将返回指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 xenroll.h
Library Uuid.lib
DLL Xenroll.dll

另请参阅

IEnroll4