IX500DistinguishedName：：Encode 方法 (certenroll.h)

Encode 方法从包含可分辨名称的字符串初始化对象。此方法已启用 Web。

语法

HRESULT Encode(
  [in] BSTR          strName,
  [in] X500NameFlags NameFlags
);

[in] strName

包含要编码的字符串的 BSTR 变量。

[in] NameFlags

一个 X500NameFlags 枚举值，该值指定编码值的格式。

注意将自动设置以下标志：

Certenroll.h 中指定的默认值为 XCN_CERT_NAME_STR_NONE。
如果未指定XCN_CERT_NAME_STR_FORWARD_FLAG，则会自动应用XCN_CERT_NAME_STR_REVERSE_FLAG。
如果未指定XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG，则会自动应用XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG。
无论指定任何其他标志，都会自动设置XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG。

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

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

返回代码/值	说明
E_OUTOFMEMORY	无法为编码值分配内存。
E_POINTER	strName 参数不能为 NULL。
HRESULT_FROM_WIN32 (ERROR_FILENAME_EXCED_RANGE)	strName 参数的长度（以字符为单位）不能超过 64 * 1024。

此方法在内部调用 CryptoAPI CertStrToName 函数。调用 Name 属性以检索以 null 结尾的字符串的名称。调用 EncodedName 属性以检索包含编码名称的字符串。