CertRDNValueToStrW 函数 (wincrypt.h)
CertRDNValueToStr 函数将CERT_RDN_VALUE_BLOB中的名称转换为以 null 结尾的字符串。
语法
DWORD CertRDNValueToStrW(
[in] DWORD dwValueType,
[in] PCERT_RDN_VALUE_BLOB pValue,
[out] LPWSTR psz,
[in] DWORD csz
);
参数
[in] dwValueType
指示要转换的 RDN 值的类型。
这可以是以下值之一：
- CERT_RDN_ANY_TYPE
- CERT_RDN_ENCODED_BLOB
- CERT_RDN_OCTET_STRING
- CERT_RDN_NUMERIC_STRING
- CERT_RDN_PRINTABLE_STRING
- CERT_RDN_TELETEX_STRING
- CERT_RDN_T61_STRING
- CERT_RDN_VIDEOTEX_STRING
- CERT_RDN_IA5_STRING
- CERT_RDN_GRAPHIC_STRING
- CERT_RDN_VISIBLE_STRING
- CERT_RDN_ISO646_STRING
- CERT_RDN_GENERAL_STRING
- CERT_RDN_UNIVERSAL_STRING
- CERT_RDN_INT4_STRING
- CERT_RDN_BMP_STRING
- CERT_RDN_UNICODE_STRING
- CERT_RDN_UTF8_STRING
[in] pValue
指向适用于 dwValueType 的类型CERT_RDN_VALUE_BLOB的指针。
[out] psz
指向缓冲区的指针，用于接收返回的字符串。
[in] csz
为返回的字符串分配的大小（以字符为单位）。 大小必须包含终止 NULL 字符。
返回值
返回转换的字符数，包括终止 NULL 字符。 如果 psz 为 NULL 或 csz 为零，则返回目标字符串的所需大小。
注解
如果 psz 不为 NULL 且 csz 不为零，则返回的 psz 始终可能是空的 以 null 结尾的字符串。
注意
wincrypt.h 标头将 CertRDNValueToStr 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | wincrypt.h |
| Library | Crypt32.lib |
| DLL | Crypt32.dll |