estrutura UNICODE_STRING (ntdef.h)

Artigo
08/25/2023

A estrutura UNICODE_STRING é usada para definir cadeias de caracteres Unicode.

Sintaxe

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

Membros

Length

O comprimento, em bytes, da cadeia de caracteres armazenada em Buffer.

MaximumLength

O comprimento, em bytes, de Buffer.

Buffer

Ponteiro para um buffer usado para conter uma cadeia de caracteres largos.

Comentários

A estrutura UNICODE_STRING é usada para passar cadeias de caracteres Unicode. Use RtlUnicodeStringInit ou RtlUnicodeStringInitEx para inicializar uma estrutura de UNICODE_STRING .

Se a cadeia de caracteres for terminada em nulo, Length não incluirá o caractere nulo à direita.

O MaximumLength é usado para indicar o comprimento do Buffer para que, se a cadeia de caracteres for passada para uma rotina de conversão, como RtlAnsiStringToUnicodeString , a cadeia de caracteres retornada não exceda o tamanho do buffer.