Funzione StringCchCatNW (strsafe.h)
Concatena il numero specificato di caratteri da una stringa a un'altra stringa. Le dimensioni del buffer di destinazione vengono fornite alla funzione per assicurarsi che non venga scritto oltre la fine del buffer.
StringCchCatN è una sostituzione delle funzioni seguenti:
Sintassi
STRSAFEAPI StringCchCatNW(
[in, out] STRSAFE_LPWSTR pszDest,
[in] size_t cchDest,
[in] STRSAFE_PCNZWCH pszSrc,
[in] size_t cchToAppend
);
Parametri
[in, out] pszDest
Tipo: LPTSTR
Buffer di destinazione che contiene la stringa da concatenare con pszSrc e riceverà l'intera stringa risultante. La stringa in pszSrc, fino ai caratteri cchMaxAppend , viene aggiunta alla fine della stringa in pszDest.
[in] cchDest
Tipo: size_t
Dimensioni del buffer di destinazione, in caratteri. Questo valore deve essere uguale alla lunghezza di pszSrc più la lunghezza di pszDest o cchMaxAppend (minore). A questa somma aggiungere 1 per l'account per il carattere null di terminazione. Il numero massimo di caratteri consentiti è STRSAFE_MAX_CCH.
[in] pszSrc
Tipo: LPCTSTR
Stringa di origine concatenata alla fine di pszDest. Questa stringa deve essere terminata con null.
[in] cchToAppend
Tipo: size_t
Numero massimo di caratteri da aggiungere a pszDest.
Valore restituito
Tipo: HRESULT
Questa funzione può restituire uno dei valori seguenti. È consigliabile usare le macro SUCCESSED e FAILED per testare il valore restituito di questa funzione.
Codice restituito | Descrizione |
---|---|
|
I dati di origine erano presenti, le stringhe sono state concatenate senza troncamento e il buffer di destinazione risultante viene terminato con null. |
|
Il valore in cchDest è maggiore di STRSAFE_MAX_CCH o il buffer di destinazione è già pieno. |
|
L'operazione di concatenazione non è riuscita a causa di spazio buffer insufficiente. Il buffer di destinazione contiene una versione troncata e terminata null del risultato previsto. In situazioni in cui il troncamento è accettabile, questo potrebbe non essere necessariamente considerato come una condizione di errore. |
Si noti che questa funzione restituisce un valore HRESULT , a differenza delle funzioni sostituite.
Commenti
Rispetto alle funzioni sostituite, StringCchCatN offre un'elaborazione aggiuntiva per la gestione corretta del buffer nel codice. La gestione del buffer insufficiente è implicata in molti problemi di sicurezza che comportano l'overrun del buffer. StringCchCatN termina sempre null e non esegue mai il overflow di un buffer di destinazione valido, anche se il contenuto della stringa di origine cambia durante l'operazione.
Il comportamento non è definito se le stringhe puntate da pszSrc e pszDest sovrapposte.
Né pszSrc né pszDest devono essere NULL. Vedere StringCchCatNEx se si richiede la gestione dei valori del puntatore di stringa Null.
StringCchCatN può essere usato nel formato generico o nelle forme più specifiche. Il tipo di dati della stringa determina la forma di questa funzione da usare.
Tipo di dati String | Stringhe letterali | Funzione |
---|---|---|
char | "stringa" | StringCchCatNA |
TCHAR | TEXT("string") | StringCchCatN |
WCHAR | L"string" | StringCchCatNW |
Nota
L'intestazione strsafe.h definisce StringCchCatN 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
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP con SP2 [app desktop | App UWP] |
Server minimo supportato | Windows Server 2003 con SP1 [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | strsafe.h |
Vedi anche
Riferimento