Informazioni su Strsafe.h

La gestione del buffer insufficiente è implicata in molti problemi di sicurezza che comportano sovraccarichi del buffer. Le funzioni definite in Strsafe.h forniscono un'elaborazione aggiuntiva per la gestione corretta del buffer nel codice. Per questo motivo, sono destinati a sostituire le controparti C/C++ predefinite e specifiche implementazioni di Windows. Strsafe.h è disponibile in Windows SDK a partire da Windows XP con Service Pack 2 (SP2).

I vantaggi delle funzioni Strsafe includono:

• Le dimensioni del buffer di destinazione vengono sempre fornite alla funzione per garantire che la funzione non venga scritta oltre la fine del buffer.

• È garantito che i buffer vengano terminati con null, anche se l'operazione tronca il risultato previsto.

• Tutte le funzioni restituiscono un valore HRESULT, con un solo codice di operazione riuscita (S_OK).

• Ogni funzione è disponibile in una versione corrispondente del conteggio dei caratteri ("cch") o del numero di byte ("cb").

• La maggior parte delle funzioni ha una versione estesa ("Ex") disponibile per le funzionalità avanzate.

Per altre informazioni, vedere le sezioni seguenti.

• Funzioni conteggio caratteri
• Funzioni conteggio byte
• Uso di Strsafe.h
• Argomenti correlati

Funzioni conteggio caratteri

Le funzioni seguenti usano un conteggio dei caratteri anziché un conteggio dei byte.

Funzione	Sostituzioni
StringCchCat StringCchCatEx	strcat, wcscat, _tcscat lstrcat StrCat StrCatBuff
StringCchCatN StringCchCatNEx	strncat StrNCat
StringCchCopy StringCchCopyEx	strcpy, wcscpy, _tcscpy lstrcpy StrCpy
StringCchCopyN StringCchCopyNEx	strncpy, wcsncpy, _tcsncpy
StringCchGets StringCchGetsEx	ottiene, _getws, _getts
StringCchPrintf StringCchPrintfEx	sprintf, swprintf, _stprintf wsprintf wnsprintf _snprintf, _snwprintf, _sntprintf
StringCchVPrintf StringCchVPrintfEx	vsprintf, vswprintf, _vstprintf vsnprintf, _vsnwprintf, _vsntprintf wvsprintf wvnsprintf ,
StringCchLength	strlen, wcslen, _tcslen

 

Funzioni conteggio byte

Le funzioni seguenti usano un conteggio dei byte anziché un conteggio dei caratteri.

Funzione	Sostituzioni
StringCbCat StringCbCatEx	strcat, wcscat, _tcscat lstrcat StrCat StrCatBuff
StringCbCatN StringCbCatNEx	strncat StrNCat
StringCbCopy StringCbCopyEx	strcpy, wcscpy, _tcscpy lstrcpy StrCpy
StringCbCopyN StringCbCopyNEx	strncpy, wcsncpy, _tcsncpy
StringCbGets StringCbGetsEx	ottiene, _getws, _getts
StringCbPrintf StringCbPrintfEx	sprintf, swprintf, _stprintf wsprintf wnsprintf _snprintf, _snwprintf, _sntprintf
StringCbVPrintf StringCbVPrintfEx	vsprintf, vswprintf, _vstprintf vsnprintf, _vsnwprintf, _vsntprintf wvsprintf wvnsprintf
StringCbLength	strlen, wcslen, _tcslen

 

Uso di Strsafe.h

• Per usare le funzioni Strsafe inline, includere il file di intestazione come illustrato di seguito, seguendo le istruzioni #include per tutti gli altri file di intestazione.

  #include <strsafe.h>

• Per usare le funzioni nel formato libreria, includere l'istruzione seguente prima di includere Strsafe.h. È tuttavia consigliabile usare le funzioni inline.

  #define STRSAFE_LIB

  Nota

  : le funzioni seguenti devono essere usate come funzioni inline: StringCbGets, StringCbGetsEx, StringCchGets e StringCchGetsEx.

   

• Quando si include Strsafe.h nel file, le funzioni precedenti sostituite dalle funzioni Strsafe.h verranno deprecate. I tentativi di usare queste funzioni meno recenti genereranno un errore del compilatore che indica di usare le funzioni più recenti. Se si vuole eseguire l'override di questo comportamento, includere l'istruzione seguente prima di includere Strsafe.h.

  #define STRSAFE_NO_DEPRECATE

• Per consentire solo le funzioni di conteggio dei caratteri, includere l'istruzione seguente prima di includere Strsafe.h.

  #define STRSAFE_NO_CB_FUNCTIONS

• Per consentire solo le funzioni di conteggio dei byte, includere l'istruzione seguente prima di includere Strsafe.h.

  #define STRSAFE_NO_CCH_FUNCTIONS

  Nota

  È possibile definire STRSAFE_NO_CB_FUNCTIONS o STRSAFE_NO_CCH_FUNCTIONS, ma non entrambi.

   

• Alcune funzioni Strsafe dispongono di versioni in grado di conoscere le impostazioni locali. Per impostazione predefinita, l'intestazione non dichiara queste funzioni. Per abilitare queste dichiarazioni, includere l'istruzione macro seguente prima di includere Strsafe.h.

  #define STRSAFE_LOCALE_FUNCTIONS

• La lunghezza massima supportata della stringa è di 2.147.483.647 (STRSAFE_MAX_CCH) caratteri, ANSI o Unicode.

Argomenti correlati

Funzioni Strsafe