通过

IPolicyQualifier：：InitializeEncode 方法（certenroll.h）

InitializeEncode 方法从字符串和标识限定符类型的值初始化对象。

Syntax

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

参数

[in] strQualifier

包含限定符的 BSTR 变量。

[in] Type

PolicyQualifierType 枚举值，该值指定应用于证书策略的限定符的类型。 这可以是以下值之一。

价值 Meaning
PolicyQualifierTypeUnknown
 未指定限定符类型。
PolicyQualifierTypeUrl
 限定符是指向证书颁发机构定义的认证实践声明（CPS）的 URL，用于概述颁发证书的策略以及证书的使用目的。
PolicyQualifierTypeUserNotice
 限定符是应用程序向依赖证书的任何用户显示的文本语句。 用户通知标识证书的允许使用。

返回值

如果函数成功，该函数将返回 S_OK。

如果函数失败，它将返回指示错误的 HRESULT 值。 可能的值包括但不限于下表中的值。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

返回代码 Description
HRESULT_FROM_WIN32（ERROR_ALREADY_INITIALIZED）
 对象已初始化。

注解

如果在 Type 参数中指定 PolicyQualifierTypeUrl，此方法将 strQualifier 参数中输入的字符串与 XCN_OID_PKIX_POLICY_QUALIFIER_CPS （1.3.6.1.5.5.5.7.2.1） 对象标识符 （OID） 相关联，并使用可分辨编码规则（DER）对其进行编码。 URL 编码为 抽象语法表示法一 （ASN.1） IA5 字符串。

如果在 Type 参数中指定 PolicyQualifierTypeUserNotice，此方法将 strQualifier 参数中输入的字符串与 XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE （1.3.6.1.5.5.7.2.2） OID 相关联，并使用 DER 对其进行编码。

可以检索此对象的以下属性：

  • ObjectId 属性检索标识限定符是 CPS 还是用户通知的 OID。
  • Qualifier 属性检索为 InitializeEncode 方法的 strQualifier 参数指定的字符串。
  • RawData 属性检索 DER 编码的限定符。
  • Type 属性检索指定限定符类型的 PolicyQualifierType 枚举的值。

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows操作系统
Header certenroll.h
DLL CertEnroll.dll

另请参阅

IPolicyQualifier

  • Last updated on