IPolicyQualifier::InitializeEncode 方法 (certenroll.h)
InitializeEncode 方法从字符串和标识限定符类型的值初始化 对象。
语法
HRESULT InitializeEncode(
[in] BSTR strQualifier,
[in] PolicyQualifierType Type
);
参数
[in] strQualifier
包含限定符的 BSTR 变量。
[in] Type
PolicyQualifierType 枚举值,该值指定应用于证书策略的限定符的类型。 这可以是以下值之一。
值 | 含义 |
---|---|
|
未指定限定符类型。 |
|
限定符是一个 URL,它指向证书颁发机构定义的认证实践声明 (CPS) ,以概述颁发证书的策略以及证书的使用目的。 |
|
限定符是应用程序要向依赖证书的任何用户显示的文本语句。 用户通知标识证书的允许使用。 |
返回值
如果函数成功,该函数将返回 S_OK。
如果函数失败,它将返回一个 指示错误的 HRESULT 值。 可能的值包括(但并不限于)下表中的项。 有关常见错误代码的列表,请参阅 通用 HRESULT 值。
返回代码 | 说明 |
---|---|
|
对象已初始化。 |
注解
如果在 Type 参数中指定 PolicyQualifierTypeUrl,此方法会将 strQualifier 参数中输入的字符串与 XCN_OID_PKIX_POLICY_QUALIFIER_CPS ( 1.3.6.1.5.5.7.2.1 关联) 对象标识符 (OID) ,并使用 可辨别编码规则 (DER) 对其进行编码。 URL 编码为 抽象语法表示法 1 (ASN.1) IA5 字符串。
如果在 Type 参数中指定 PolicyQualifierTypeUserNotice,此方法会将 strQualifier 参数中输入的字符串与 XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE ( 1.3.6.1.5.5.5.7.2.2) OID 相关联,并使用 DER 对其进行编码。
可以检索此对象的以下属性:
- ObjectId 属性检索标识限定符是 CPS 还是用户通知的 OID。
- 限定符属性检索为 InitializeEncode 方法的 strQualifier 参数指定的字符串。
- RawData 属性检索 DER 编码的限定符。
- Type 属性检索指定限定符类型的 PolicyQualifierType 枚举的值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | certenroll.h |
DLL | CertEnroll.dll |