Compartilhar via


Função RtlAppendStringToString (ntifs.h)

A rotina RtlAppendStringToString concatena duas cadeias de caracteres contadas. Ele copia bytes da origem até o comprimento do buffer de destino.

Sintaxe

NTSYSAPI NTSTATUS RtlAppendStringToString(
  [in, out] PSTRING      Destination,
  [in]      const STRING *Source
);

Parâmetros

[in, out] Destination

Um ponteiro para uma cadeia de caracteres contada à qual a cadeia de caracteres em Source deve ser acrescentada.

[in] Source

Um ponteiro para uma cadeia de caracteres contada a ser acrescentada à cadeia de caracteres em Destino.

Retornar valor

A rotina RtlAppendStringToString retorna STATUS_SUCCESS se acrescentar a cadeia de caracteres em Origem à cadeia de caracteres em Destino. RtlAppendStringToString retorna STATUS_BUFFER_TOO_SMALL se MaximumLength da cadeia de caracteres Destination for muito pequena para permitir que a cadeia de caracteres de origem seja acrescentada.

Comentários

A soma dos membros Length das cadeias de caracteres Destination e Source deve ser menor ou igual ao MaximumLength da cadeia de caracteres Destination .

Para obter informações sobre outras rotinas de tratamento de cadeia de caracteres, consulte Rotinas rtl (biblioteca em tempo de execução).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h, FltKernel.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

RtlAppendUnicodeStringToString

RtlAppendUnicodeToString

RtlInitString