Condividi tramite


Funzione StrNCatA (shlwapi.h)

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

Nota Non utilizzare questa funzione o la macro StrCatN . Vedere La sezione 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 sufficientemente grande per contenere le stringhe combinate più il carattere Null di terminazione.

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.

Osservazioni

avviso di sicurezza: L'uso di questa funzione in modo non corretto può compromettere la sicurezza dell'applicazione. Il primo argomento, psz1, deve essere sufficientemente grande da contenere psz2 e la chiusura '\0', in caso contrario potrebbe verificarsi un sovraccarico del buffer. I sovraccarichi del buffer possono causare un attacco Denial of Service all'applicazione se si verifica una violazione di accesso. Nel peggiore dei casi, un sovraccarico del buffer può consentire a un utente malintenzionato di inserire codice eseguibile nel processo, soprattutto se psz1 è un buffer basato su stack. Tenere presente che l'ultimo argomento, cchMax, è il numero di caratteri da copiare in psz1, non necessariamente la dimensione del psz1 in byte. Prendere in considerazione l'uso di una delle alternative seguenti. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCatCat, StringCchCatEx, StringCchCatNo StringCchCatNEx. Prima di continuare, esaminare Considerazioni sulla sicurezza: Microsoft Windows Shell.

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione shlwapi.h
libreria Shlwapi.lib
dll Shlwapi.dll (versione 4.71 o successiva)