RtlAnsiStringToUnicodeSize 宏 (wdm.h)
RtlAnsiStringToUnicodeSize 例程返回保存转换为 Unicode 字符串的 ANSI 字符串所需的字节数。
语法
//
// NTSYSAPI
// ULONG
// NTAPI
// RtlAnsiStringToUnicodeSize(
// PANSI_STRING AnsiString
// );
//
#define RtlAnsiStringToUnicodeSize(STRING) ( \
RtlxAnsiStringToUnicodeSize(STRING) \
)
参数
[in] STRING
指向包含 ANSI 字符串的缓冲区的指针。
返回值
无
备注
RtlAnsiStringToUnicodeSize 返回一个 ULONG 值,该值包含保存转换为 Unicode 字符串的 ANSI 字符串所需的字节数。
将 RtlAnsiStringToUnicodeSize 例程的返回值强制转换为 USHORT 可能会导致数据丢失。 为了避免潜在问题,此例程的调用方应测试算术溢出的返回值。 请注意,尾随 NULL 的 RtlAnsiStringToUnicodeSize 帐户。
RtlAnsiStringToUnicodeSize 的调用方必须在 IRQL = PASSIVE_LEVEL 运行。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 从 Windows 2000 开始可用。 |
目标平台 | 通用 |
标头 | wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |