Funzione StrCatBuffW (shlwapi.h)

Articolo
11/20/2024

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

Nota Non usare. Vedere La sezione Osservazioni per le funzioni alternative.

Sintassi

PWSTR StrCatBuffW(
  [in, out] PWSTR  pszDest,
  [in]      PCWSTR 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 accodato.

[in] pszSrc

Tipo: PCTSTR

Puntatore alla stringa da aggiungere a pszDest.

cchDestBuffSize

Tipo: int

Dimensione 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 adattarsi all'intera stringa, la stringa verrà troncata.

Valore restituito

Tipo: PTSTR

Restituisce un puntatore alla stringa di destinazione.

Osservazioni

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. Prendere in considerazione l'uso di una delle alternative seguenti: StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatNo StringCchCatNEx. Prima di continuare, esaminare 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 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 5.0 o successiva)

Condividi tramite