Função RtlInitStringEx (ntifs.h)

A rotina rtlInitStringEx inicializa uma cadeia de caracteres contada de 8 bits.

Sintaxe

NTSYSAPI NTSTATUS RtlInitStringEx(
  [out]          PSTRING               DestinationString,
  [in, optional] __drv_aliasesMem PCSZ SourceString
);

Parâmetros

[out] DestinationString

Um ponteiro para a estrutura string a ser inicializada. O arquivo de cabeçalho Ntdef.h define essa estrutura como idêntica à estrutura de ANSI_STRING.

[in, optional] SourceString

Um ponteiro para uma cadeia de caracteres terminada em nulo. Essa cadeia de caracteres é usada para inicializar a cadeia de caracteres contada apontada por DestinationString.

Valor de retorno

Retorna STATUS_NAME_TOO_LONG se o SourceString for muito longo. Caso contrário, essa rotina retornará STATUS_SUCCESS.

Observações

Essa rotina inicializa uma cadeia de caracteres contada.

A rotina copia o valor do ponteiro SourceString para o membro do Buffer da estrutura string de apontada pelo DestinationString. O Length membro dessa estrutura é definido como o comprimento, em bytes, da cadeia de caracteres de origem, excluindo o nulo de terminação. O membro MaximumLength da estrutura é definido como o comprimento, em bytes, da cadeia de caracteres de origem, incluindo o nulo de terminação. Se SourceString for NULL, Length e MaximumLength serão definidos como zero.

RtlInitStringEx não altera a cadeia de caracteres de origem apontada por SourceString.

Os chamadores de RtlInitStringEx podem estar em execução no IRQL <= DISPATCH_LEVEL se o buffer de DestinationString não for de página. Normalmente, os chamadores são executados em IRQL = PASSIVE_LEVEL porque a maioria dos outros rtlxxxcadeia de caracteres rotinas não pode ser chamada na > PASSIVE_LEVEL IRQL.

Requisitos

Consulte também

ANSI_STRING