Função StrNCatW (shlwapi.h)

Acrescenta um número especificado de caracteres do início de uma cadeia de caracteres ao final de outra.

Nota Não use essa função ou a macro StrCatN . Consulte Comentários para funções alternativas.

 

Sintaxe

PWSTR StrNCatW(
  [in, out] PWSTR  psz1,
            PCWSTR psz2,
            int    cchMax
);

Parâmetros

[in, out] psz1

Tipo: PTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo à qual a função acrescenta os caracteres de psz2. Ele deve ser grande o suficiente para manter as cadeias de caracteres combinadas mais o caractere nulo de terminação.

psz2

Tipo: PCTSTR

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

cchMax

Tipo: int

O número de caracteres a serem acrescentados a psz1 desde o início do psz2.

Retornar valor

Tipo: PTSTR

Retorna um ponteiro para psz1, que contém a cadeia de caracteres combinada.

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, um estouro de buffer pode permitir que um invasor injete código executável em seu processo, especialmente se psz1 for um buffer baseado em pilha. Lembre-se de que o último argumento, cchMax, é o número de caracteres a serem copiados para psz1, não necessariamente o tamanho do psz1 em bytes. Considere usar uma das alternativas a seguir. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatN ou StringCchCatNEx. Você deve examinar considerações de segurança: Microsoft Windows Shell antes de continuar.

Observação

O cabeçalho shlwapi.h define StrNCat como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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)