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.

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.

Requisitos