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 可能会导致数据丢失。 为了避免潜在问题,此例程的调用方应测试算术溢出的返回值。 请注意,尾随 NULLRtlAnsiStringToUnicodeSize 帐户。

RtlAnsiStringToUnicodeSize 的调用方必须在 IRQL = PASSIVE_LEVEL 运行。

要求

要求
最低受支持的客户端 从 Windows 2000 开始可用。
目标平台 通用
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另请参阅

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize