Função RtlInitStringEx (wdm.h)

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

Sintaxe

C++

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 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.

Retornar valor

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

Comentários

Essa rotina inicializa uma cadeia de caracteres contada.

A rotina copia o valor do ponteiro SourceString para o membro Buffer da estrutura STRING apontada por DestinationString. O membro Length 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 em IRQL <= DISPATCH_LEVEL se o buffer DestinationString não for pageable. Normalmente, os chamadores são executados em IRQL = PASSIVE_LEVEL porque a maioria das outras rotinas rtlxxxstring não podem ser chamadas no IRQL > PASSIVE_LEVEL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 10.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Consulte a seção Observações.

Confira também

ANSI_STRING