Função RtlAppendUnicodeStringToString (wdm.h)

  • Artigo

A rotina RtlAppendUnicodeStringToString concatena duas cadeias de caracteres Unicode.

Sintaxe

NTSYSAPI NTSTATUS RtlAppendUnicodeStringToString(
  [in, out] PUNICODE_STRING  Destination,
  [in]      PCUNICODE_STRING Source
);

Parâmetros

[in, out] Destination

Ponteiro para uma cadeia de caracteres Unicode em buffer.

[in] Source

Ponteiro para a cadeia de caracteres em buffer a ser concatenada.

Retornar valor

RtlAppendUnicodeStringToString pode retornar um dos seguintes:

Código de retorno Descrição
STATUS_SUCCESS
 A cadeia de caracteres de origem foi acrescentada com êxito à cadeia de caracteres contada de destino. O comprimento da cadeia de caracteres de destino é atualizado para incluir os bytes acrescentados.
STATUS_BUFFER_TOO_SMALL
 O comprimento da cadeia de caracteres de destino é muito pequeno para permitir que a cadeia de caracteres de origem seja concatenada. Assim, o comprimento da cadeia de caracteres de destino não é atualizado.

Comentários

RtlAppendUnicodeStringToString Copia bytes da origem para a cadeia de caracteres de destino especificada, depois que o conteúdo atual da cadeia de caracteres de destino e o comprimento de destino são incrementados pelo número de bytes copiados.

Os buffers de Destino e Origem deverão ser residentes se o chamador estiver em execução em IRQL >= DISPATCH_LEVEL.

Requisitos

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

Confira também

RtlAppendUnicodeToString