Estrutura STRING (ntdef.h)

Artigo
03/05/2024

A estrutura ANSI_STRING define uma cadeia de caracteres contada usada para cadeias de caracteres ANSI.

Sintaxe

typedef struct _STRING {
  USHORT Length;
  USHORT MaximumLength;
  PCHAR  Buffer;
} STRING;

Membros

Length

O comprimento em bytes da cadeia de caracteres armazenada no buffer apontado por Buffer.

MaximumLength

O comprimento em bytes do buffer apontado por Buffer.

Buffer

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

Comentários

A estrutura ANSI_STRING é usada para passar cadeias de caracteres ANSI. Use a rotina RtlInitAnsiString para inicializar um ANSI_STRING.

Se a cadeia de caracteres for terminada em nulo, Length não incluirá o NULL de terminação.

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 RtlUnicodeStringToAnsiString , a cadeia de caracteres retornada não exceda o tamanho do buffer.