Função lstrcatW (winbase.h)

Acrescenta uma cadeia de caracteres a outra.

Aviso Não use. Considere usar StringCchCat. Confira as considerações de segurança.

 

Sintaxe

LPWSTR lstrcatW(
  [in, out] LPWSTR  lpString1,
  [in]      LPCWSTR lpString2
);

Parâmetros

[in, out] lpString1

Tipo: LPTSTR

A primeira cadeia de caracteres terminada em nulo. Esse buffer deve ser grande o suficiente para conter ambas as cadeias de caracteres.

[in] lpString2

Tipo: LPTSTR

A cadeia de caracteres terminada em nulo a ser acrescentada à cadeia de caracteres especificada no parâmetro lpString1.

Valor de retorno

Tipo: LPTSTR

Se a função for bem-sucedida, o valor retornado será um ponteiro para o buffer.

Se a função falhar, o valor retornado será NULL e lpString1 poderá não ser encerrado em nulo.

Observações

Nota

O cabeçalho winbase.h define lstrcat como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winbase.h (inclua Windows.h)
biblioteca	Kernel32.lib
de DLL	Kernel32.dll

Consulte também

Conceitual

de referência de

StringCbCat

StringCbCatEx

StringCbCatN

StringCbCatNEx

stringCchCat

StringCchCatEx

stringCchCatN

stringCchCatNEx

cadeias de caracteres

lstrcmp

lstrcmpi

lstrlen