Função StrCatW (shlwapi.h)

Acrescenta uma cadeia de caracteres a outra.

Nota Não use. Consulte Comentários para obter funções alternativas.

 

Sintaxe

PWSTR StrCatW(
  [in, out] PWSTR  psz1,
  [in]      PCWSTR psz2
);

Parâmetros

[in, out] psz1

Tipo: PTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo. Quando essa função retorna com êxito, essa cadeia de caracteres contém seu conteúdo original com a cadeia de caracteres psz2 acrescentada. Esse buffer deve ser grande o suficiente para manter as cadeias de caracteres e o caractere nulo de terminação.

[in] psz2

Tipo: PCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo a ser acrescentada a psz1.

Retornar valor

Tipo: PTSTR

Retorna um ponteiro para psz1, que contém as cadeias de caracteres combinadas.

Comentários

Aviso de segurança: Usar essa função incorretamente pode comprometer a segurança do aplicativo. O primeiro argumento, psz1, deve ser grande o suficiente para manter psz2 e o fechamento '\0', caso contrário, um estouro de buffer pode ocorrer. Os estouros de buffer podem levar a um ataque de negação de serviço contra o aplicativo se ocorrer uma violação de acesso. Na pior das hipóteses, uma sobrecarga de buffer pode permitir que um invasor injete código executável em seu processo, especialmente se o psz1 for um buffer baseado em pilha. Considere usar uma das seguintes alternativas: StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatN ou StringCchCatNEx. Você deve examinar considerações de segurança: Microsoft Windows Shell antes de continuar.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 4.71 ou posterior)