UNICODE_STRING 結構 (ntdef.h)

UNICODE_STRING 結構可用來定義 Unicode 字串。

語法

typedef struct _UNICODE_STRING {
  USHORT Length;
  USHORT MaximumLength;
  PWSTR  Buffer;
} UNICODE_STRING, *PUNICODE_STRING;

成員

Length

儲存在 Buffer 中之字串的長度,以位元組為單位。

MaximumLength

Buffer 的長度,以位元組為單位。

Buffer

緩衝區的指標,用來包含寬字元字串。

備註

UNICODE_STRING 結構用來傳遞 Unicode 字串。 使用 RtlUnicodeStringInitRtlUnicodeStringInitEx 初始化 UNICODE_STRING 結構。

如果字串為 Null 終止, Length 就不會包含尾端 Null 字元。

MaximumLength 用來指出 Buffer 的長度,如此一來,如果字串傳遞至轉換例程,例如 RtlAnsiStringToUnicodeString,則傳回的字串不會超過緩衝區大小。

規格需求

需求
標頭 ntdef.h (包括 Wdm.h、Ntddk.h、Ntdef.h)

另請參閱

ANSI_STRING

OEM_STRING

RtlAnsiStringToUnicodeSize

RtlAnsiStringToUnicodeString

RtlFreeUnicodeString

RtlInitUnicodeString

RtlUnicodeStringToAnsiSize

RtlUnicodeStringToAnsiString