Função RtlInitEmptyAnsiString (wdm.h)

A macro RtlInitEmptyAnsiString inicializa uma cadeia de caracteres ANSI contada vazia.

Sintaxe

void RtlInitEmptyAnsiString(
  [out] PANSI_STRING           AnsiString,
  [in]  __drv_aliasesMem PCHAR Buffer,
  [in]  USHORT                 BufferSize
);

Parâmetros

[out] AnsiString

Ponteiro para a estrutura de ANSI_STRING a ser inicializada.

[in] Buffer

Ponteiro para um buffer alocado pelo chamador a ser usado para conter uma cadeia de caracteres ANSI composta por elementos CHAR.

[in] BufferSize

Comprimento, em bytes, do buffer para o qual o Buffer aponta.

Retornar valor

Nenhum

Comentários

Os membros da estrutura para a qual o parâmetro DestinationString aponta são inicializados da seguinte maneira.

  • Comprimento. Zero.

  • MaximumLength. BufferSize.

  • Buffer. SourceString.

Para inicializar uma cadeia de caracteres ANSI contada não vazia, chame RtlInitAnsiString.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Cabeçalho wdm.h
IRQL Qualquer nível