CryptBinaryToStringA 函数 (wincrypt.h)
CryptBinaryToString 函数将字节数组转换为格式化字符串。
语法
BOOL CryptBinaryToStringA(
[in] const BYTE *pbBinary,
[in] DWORD cbBinary,
[in] DWORD dwFlags,
[out, optional] LPSTR pszString,
[in, out] DWORD *pcchString
);
参数
[in] pbBinary
指向要转换为字符串的字节数组的指针。
[in] cbBinary
pbBinary 数组中的元素数。
[in] dwFlags
指定生成的格式化字符串的格式。 此参数的取值可为下列值之一:
值 | 含义 |
---|---|
|
Base64,具有证书开头和结束标头。 |
|
Base64,不带标头。 |
|
纯二进制副本。 |
|
Base64,具有请求开头和结束标头。 |
|
仅十六进制。 |
|
十六进制,显示 ASCII 字符。 |
|
Base64,带有 X.509 CRL 开头和结束标头。 |
|
十六进制,显示地址。 |
|
十六进制,显示 ASCII 字符和地址。 |
|
原始十六进制字符串。
Windows Server 2003 和 Windows XP: 不支持此值。 |
|
不带标头的 Base64,“+”替换为“-”,“/”替换为 RFC 4648 第 5 节中定义的“_”。 |
|
强制严格解码 ASN.1 文本格式。 某些 ASN.1 二进制 BLOB 可能会错误地将 BLOB 的前几个字节解释为 Base64 文本。 在这种情况下,将忽略其余文本。 使用此标志强制执行 BLOB 的完整解码。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 不支持此值。 |
除了上述值之外,还可以指定以下一个或多个值来修改函数的行为。
[out, optional] pszString
指向接收转换字符串的缓冲区的指针。 若要计算必须分配以保存返回的字符串的字符数,请将此参数设置为 NULL。 函数会将所需数量的字符(包括终止 NULL 字符)放在 pcchString 指向的值中。
[in, out] pcchString
指向 DWORD 变量的指针,该变量包含 pszString 缓冲区的大小(以 TCHAR为单位)。 如果 pszString 为 NULL,则函数计算返回字符串的长度, (包括 TCHARs 中的终止 null 字符) ,并在此参数中返回它。 如果 pszString 不为 NULL 且不够大,则该函数会将二进制数据转换为指定的字符串格式(包括终止 null 字符),但 pcchString 接收 TCHARs 的长度,不包括终止 null 字符。
返回值
如果函数成功,则函数) 返回非零 (TRUE 。
如果函数失败,则返回零 (FALSE) 。
注解
除了使用 CRYPT_STRING_BINARY 编码外,所有字符串都追加了新的行序列。 默认情况下,新行序列是 CR/LF 对 (0x0D/0x0A) 。 如果 dwFlags 参数包含 CRYPT_STRING_NOCR 标志,则新行序列是 LF 字符 (0x0A) 。 如果 dwFlags 参数包含 CRYPT_STRING_NOCRLF 标志,则不会向字符串追加新的行序列。
注意
wincrypt.h 标头将 CryptBinaryToString 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | wincrypt.h |
Library | Crypt32.lib |
DLL | Crypt32.dll |