Função RtlAppendUnicodeToString (wdm.h)

  • Artigo

A rotina RtlAppendUnicodeToString concatena a cadeia de caracteres Unicode fornecida para uma cadeia de caracteres Unicode em buffer.

Sintaxe

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

Parâmetros

[in, out] Destination

Um ponteiro para a cadeia de caracteres em buffer.

[in, optional] Source

Um ponteiro para a cadeia de caracteres terminada em nulo a ser acrescentada à cadeia de caracteres de destino .

Retornar valor

RtlAppendUnicodeToString 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 de destino e o comprimento da cadeia de caracteres de destino foi atualizado para incluir os bytes acrescentados.
STATUS_BUFFER_TOO_SMALL
 O buffer de cadeia de caracteres de destino é muito pequeno para permitir que a cadeia de caracteres de origem seja acrescentada, portanto, o comprimento da cadeia de caracteres de destino não é atualizado e o conteúdo do buffer de cadeia de caracteres de destino não é alterado.

Comentários

RtlAppendUnicodeToString acrescenta a cadeia de caracteres de origem ao final da cadeia de caracteres de destino.

Se o buffer de destino não for grande o suficiente para conter a cadeia de caracteres resultante da concatenação das cadeias de caracteres de origem e destino (sem incluir o caractere nulo que encerra a cadeia de caracteres de origem), a rotina retornará STATUS_BUFFER_TOO_SMALL e deixará a cadeia de caracteres de destino inalterada.

O buffer de destino deverá ser residente 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 (modo kernel); Ntdll.dll (modo de usuário)
IRQL Consulte a seção Observações.

Confira também

RtlAppendUnicodeStringToString