Função StrNCatA (shlwapi.h)

Artigo
11/20/2024

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

Observação 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 a psz1 desde o início de psz2.

Valor de retorno

Tipo: PTSTR

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

Observações

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, pode ocorrer uma sobrecarga de buffer. Os excessos 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 insira 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, StringCchCatNou StringCchCatNEx. Você deve examinar considerações de segurança: Microsoft Windows Shell antes de continuar.

Nota

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. 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, Windows XP [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	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 4.71 ou posterior)

Compartilhar via