Funzione StrCatBuffA (shlwapi.h)

Articolo
08/26/2023

Copia e aggiunge caratteri da una stringa alla fine di un'altra.

Nota Non usare. Per le funzioni alternative, vedere La sezione Osservazioni.

Sintassi

PSTR StrCatBuffA(
  [in, out] PSTR  pszDest,
  [in]      PCSTR pszSrc,
            int   cchDestBuffSize
);

Parametri

[in, out] pszDest

Tipo: PTSTR

Puntatore a una stringa con terminazione Null. Quando questa funzione viene restituita correttamente, questa stringa contiene il contenuto originale con la stringa pszSrc aggiunta.

[in] pszSrc

Tipo: PCTSTR

Puntatore alla stringa da aggiungere a pszDest.

cchDestBuffSize

Tipo: int

Dimensioni del buffer, in caratteri, a cui punta pszDest. Questo valore deve essere almeno la lunghezza della stringa combinata più il carattere Null di terminazione. Se il buffer è troppo piccolo per adattare l'intera stringa, la stringa verrà troncata.

Valore restituito

Tipo: PTSTR

Restituisce un puntatore alla stringa di destinazione.

Commenti

Avviso di sicurezza: L'uso di questa funzione in modo non corretto può compromettere la sicurezza dell'applicazione. Non è garantito che la stringa finale sia con terminazione Null. È consigliabile usare una delle alternative seguenti: StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCatEx, StringCchCatEx, StringCchCatN o StringCchCatNEx. Prima di continuare, vedere Considerazioni sulla sicurezza: Microsoft Windows Shell .

Nota

L'intestazione shlwapi.h definisce StrCatBuff 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite