RtlAnsiStringToUnicodeSize routine

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