Funzione StrNCatA (shlwapi.h)

Articolo
03/15/2023

Aggiunge un numero specificato di caratteri dall'inizio di una stringa alla fine di un'altra.

Nota Non usare questa funzione o la macro StrCatN . Vedere Osservazioni per le funzioni alternative.

Sintassi

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR psz2,
            int   cchMax
);

Parametri

[in, out] psz1

Tipo: PTSTR

Puntatore a una stringa con terminazione null a cui la funzione aggiunge i caratteri da psz2. Deve essere abbastanza grande per contenere le stringhe combinate e il carattere null terminante.

psz2

Tipo: PCTSTR

Puntatore alla stringa con terminazione null da aggiungere.

cchMax

Tipo: int

Numero di caratteri da aggiungere a psz1 dall'inizio di psz2.

Valore restituito

Tipo: PTSTR

Restituisce un puntatore a psz1, che contiene la stringa combinata.

Commenti

Avviso di sicurezza: L'uso di questa funzione in modo errato può compromettere la sicurezza dell'applicazione. Il primo argomento, psz1, deve essere abbastanza grande per contenere psz2 e la chiusura '\0', in caso contrario, potrebbe verificarsi un overrun del buffer. Gli overrun del buffer possono causare un attacco denial of service all'applicazione se si verifica una violazione di accesso. Nel caso peggiore, un overrun del buffer può consentire a un utente malintenzionato di inserire codice eseguibile nel processo, soprattutto se psz1 è un buffer basato sullo stack. Tenere presente che l'ultimo argomento, cchMax, è il numero di caratteri da copiare in psz1, non necessariamente la dimensione del psz1 in byte. È consigliabile usare una delle alternative seguenti. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat,StringCchCatEx, StringCchCatN o StringCchCatNEx. È consigliabile esaminare considerazioni sulla sicurezza: Microsoft Windows Shell prima di continuare.

Nota

L'intestazione shlwapi.h definisce StrNCat come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite