Função StrNCatA (shlwapi.h)

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

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

 

Sintaxe

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR 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 ao psz1 desde o início do psz2.

Valor retornado

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, 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. 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

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)