RtlAnsiStringToUnicodeSize routine

RtlAnsiStringToUnicodeSize 返回一个ANSI字符串转换为Unicode字符串后需要多少字节的储存空间。

Syntax

 ULONG RtlAnsiStringToUnicodeSize(  _In_ PANSI_STRING AnsiString); 

Parameters

AnsiString [in]

指向一个包含ANSI 字符串的缓冲区。

Return value

RtlAnsiStringToUnicodeSize 返回为转换为宽字符后必需的大小，以字节为大小。

Remarks

Note  转换 RtlAnsiStringToUnicodeSize 返回到 USHORT 可能引起数据的丢失.为了避免这一个潜在的问题，调用者应当测试返回值是否有数值溢出. 注意RtlAnsiStringToUnicodeSize 计算长度时将结尾的 NULL包含在内.

 

Callers of RtlAnsiStringToUnicodeSize must be running at IRQL = PASSIVE_LEVEL.

Requirements

Target platform

Universal

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

PASSIVE_LEVEL

See also

RtlAnsiStringToUnicodeString

RtlxAnsiStringToUnicodeSize