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
指定要创建的证书请求类型的值。 指定以下值之一。
值 | 含义 |
---|---|
|
完整 CMC |
|
PKCS #10 |
|
PKCS #10 版本 2 |
|
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 |