UNICODE_STRING structure

UNICODE_STRING structure

The UNICODE_STRING structure is used to define Unicode strings.

Syntax

typedef struct _UNICODE_STRING {

USHORT Length;

USHORT MaximumLength;

PWSTR Buffer;

} UNICODE_STRING, *PUNICODE_STRING;

Members

Length

Buffer中存放的字符串的长度，以字节为单位。

MaximumLength

Buffer的长度，以字节为单位。

Buffer

指向一个包含宽字节字符串的缓冲区的指针。

Remarks

The UNICODE_STRING 用于传递 Unicode 字符串. 使用 RtlUnicodeStringInit 或者 RtlUnicodeStringInitEx 初始化一个UNICODE_STRING 结构。

如果字符串是null结尾的， Length 不包含最后一个null字符。 MaximumLength 用于标识 Buffer 的长度，以便于如果字符串传递给一个转换函数如RtlAnsiStringToUnicodeString 的时候返回的字符串不会超过缓冲区的大小。

Requirements

Header

Ntdef.h (include Wdm.h or Ntddk.h)

See also

OEM_STRING

ANSI_STRING

RtlAnsiStringToUnicodeSize

RtlAnsiStringToUnicodeString

RtlFreeUnicodeString

RtlInitUnicodeString

RtlUnicodeStringToAnsiSize

RtlUnicodeStringToAnsiString