Upozornění C28719

Článek
12/15/2024

Zakázané použití rozhraní API: název funkce je nezabezpečený a je označený jako zastaralý.

Toto upozornění značí, že se používá funkce, která je zakázaná a má robustnější nebo bezpečnější náhradu.

Poznámky

Seznam všech zakázaných funkcí, na které se tato chyba vztahuje, proč jsou zakázány, a doporučené náhrady lze najít po následujícím příkladu.

Název analýzy kódu: BANNED_API_USAGE

Příklad

Následující kód vygeneruje toto upozornění:

void example_func(PSTR src) 
{ 
    char dst[100]; 
    strcpy(dst, src);
}

Tento problém vychází z použití nebezpečné funkce strcpy. strcpy nekontroluje, jestli je cílová vyrovnávací paměť dostatečně velká, aby odpovídala zdrojovým datům.

K vyřešení tohoto problému můžeme použít strcpy_s, bezpečnější náhradu této funkce v jazyce C++11. strcpy_s má třetí parametr (velikost cílové vyrovnávací paměti), aby se zajistilo, že se zkopíruje pouze mnoho bajtů. Například následující kód je bezpečnější:

void example_func(PSTR src) 
{ 
    char dst[100]; 
    strcpy_s(dst, sizeof(dst), src); 
}

Zakázané funkce

POZNÁMKA: Tento seznam se aktivně aktualizuje a vylepšuje

Zakázané rozhraní API	Náhrada/Náhrady	Odůvodnění / poznámky
`_fstrcat`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Implementace staršího 16bitového vzdáleného ukazatele
`_fstrcpy`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Implementace staršího 16bitového ukazatele do dálky
`_fstrncat`	`StringCbCatN`, `StringCbCatNEx`, `StringCchCatN`, `StringCchCatNEx`	Implementace staršího 16bitového vzdáleného ukazatele
`_fstrncpy`	`strncpy`, `wcsncpy`	Implementace starých 16bitových farpointerů
`_ftccat`	`strcat`, `wcscat`	Implementace 16bitového staršího farového ukazatele
`_ftccpy`	`strcpy`, `wcscpy`	Implementace staršího 16bitového "far pointeru"
`_ftcscat`	`strcat`, `wcscat`	Implementace staršího 16bitového vzdáleného ukazatele
`_ftcscpy`	`strcpy`, `wcscpy`	Implementace zděděného 16bitového vzdáleného ukazatele
`_getts`	`StringCbGets`, `StringCbGetsEx`, `StringCchGets`, `StringCchGetsEx`, `gets_s`	Bez omezení velikosti u dat
`_gettws`	`gets_s`	Bez omezení velikosti u dat
`_getws`	`_getws_s`	Bez omezení velikosti u dat
`_mbccat`	`strcat_s`, `StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`, `strlcat`	Bez omezení velikosti u dat
`_makepath`	`_makepath_s`	Bez omezení velikosti u dat
`_mbscat`	`_mbscat_s`
`_snprintf`	`_snprintf_s`	Neukončuje nulovým znakem
`_sntprintf`	`StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Není ukončeno znakem NULL
`_sntscanf`	`_snscanf_s`	Bez maximální délky
`_snwprintf`	`_snwprintf_s`, `StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Není ukončeno znakem NULL
`_splitpath`	`_splitpath_s`	Bez kontroly hranic
`_stprintf`	`StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Omezená detekce chyb
`_stscanf`	`sscanf_s` (vyžaduje změny formátu řetězce)	Bez kontroly hranic
`_tccat`	`strcat_s`, `StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`, `strlcat`	Bez kontroly hranic
`_tccpy`	`strcpy_s`, `StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`, `strlcpy`	Bez kontroly hranic
`_tcscat`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`_tcscpy`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Omezená detekce chyb
`_tcsncat`	`StringCbLength`, `StringCchLength`, `UnalignedStringCbLength`, `UnalignedStringCchLength`	Bez maximální délky
`_tcsncpy`	`StringCbCopyN`, `StringCbCopyNEx`, `StringCchCopyN`, `StringCchCopyNEx`	Omezená detekce chyb
`_tmakepath`	`_makepath_s`	Bez kontroly hranic
`_tscanf`	`scanf_s`	Žádná kontrola hranic pro výstupy
`_tsplitpath`	`splitpath_s`, `wsplitpath_s`	Bez kontroly hranic
`_vsnprintf`	`_vsnprintf_s`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Omezená detekce chyb
`_vsntprintf`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Omezená detekce chyb
`_vsnwprintf`	`_vsnwprintf_s`, `StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`	Omezená detekce chyb
`_vstprintf`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrinfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Bez maximální délky
`_wmakepath`	`_wmakepath_s`	Bez kontroly hranic
`_wsplitpath`	`_wsplitpath_s`	Bez kontroly hranic
`OemToCharW`	`WideCharToMultiByte`	Bez kontroly hranic
`StrCat`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`StrCatA`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`StrCatBuff`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Bez ukončení s hodnotou NULL
`StrCatBuffA`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Bez ukončení s hodnotou NULL
`StrCatBuffW`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Bez ukončení s hodnotou NULL
`StrCatChainW`	`StringCbCatEx`, `StringCbCatNEx`, `StringCchCatEx`, `StringCchCatNEx`	Bez ukončení nulovým znakem
`StrCatN`	`StringCbCat`, `StringCbCatEx`, `StringCbCatN`, `StringCbCatNEx`, `StringCchCat`, `StringCchCatEx`, `StringCchCatN`, `StringCchCatNEx`	Bez kontroly hranic
`StrCatNA`	`StringCbCat`, `StringCbCatEx`, `StringCbCatN`, `StringCbCatNEx`, `StringCchCat`, `StringCchCatEx`, `StringCchCatN`, `StringCchCatNEx`	Bez kontroly hranic
`StrCatNW`	`StringCbCat`, `StringCbCatEx`, `StringCbCatN`, `StringCbCatNEx`, `StringCchCat`, `StringCchCatEx`, `StringCchCatN`, `StringCchCatNEx`	Bez kontroly hranic
`StrCatW`	`StringCbCat`, `StringCbCatEx`, `StringCbCatN`, `StringCbCatNEx`, `StringCchCat`, `StringCchCatEx`, `StringCchCatN`, `StringCchCatNEx`	Bez kontroly hranic
`StrCpy`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`StrCpyA`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`StrCpyN`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Neukončuje nulovým znakem
`StrCpyNA`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Neukončuje hodnotou NULL
`StrCpyNW`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Omezená kontrola chyb
`strcpyW`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`StrCpyW`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`StrNCat`	`StringCbCatN`, `StringCbCatNEx`, `StringCchCatN`, `StringCchCatNEx`	Omezená detekce chyb
`StrNCatA`	`StringCbCatN`, `StringCbCatNEx`, `StringCchCatN`, `StringCchCatNEx`	Omezená detekce chyb
`StrNCatW`	`StringCbCatN`, `StringCbCatNEx`, `StringCchCatN`, `StringCchCatNEx`	Omezená detekce chyb
`StrNCpy`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Neukončuje nulovým znakem
`StrNCpyA`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Není ukončeno znakem NULL
`StrNCpyW`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Není ukončeno znakem NULL
`gets`	`gets_s`, `fgets`, `StringCbGets`, `StringCbGetsEx`, `StringCchGets`, `StringCchGetsEx`	Omezená detekce chyb; zastaralé podle standardu C11
`lstrcat`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`lstrcatA`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`lstrcatn`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`lstrcatnA`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`lstrcatnW`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`lstrcatW`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`lstrcpy`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`lstrcpyA`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`lstrcpyn`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Omezená detekce chyb
`lstrcpynA`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Omezená detekce chyb
`lstrcpynW`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`lstrcpyW`	`StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`	Bez kontroly hranic
`snscanf`	`sscanf_s`	Bez kontroly hranic
`snwscanf`	`swscanf_s`	Bez kontroly hranic
`sprintf`	`sprintf_s`	Omezená detekce chyb
`sprintfA`	`sprintf_s`	Bez kontroly hranic
`sprintfW`	`swprintf_s`	Bez kontroly hranic
`lstrncat`	`StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`	Omezená detekce chyb
`makepath`
`nsprintf`	`sprintf_s`	Žádná detekce chyb ani kontrola hranic
`strcat`	`strcat_s`, `StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`, `strlcat`	Omezená detekce chyb
`strcatA`	`strcat_s`, `StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`, `strlcat`	Omezená detekce chyb
`strcatW`	`strcat_s`, `StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`, `strlcat`	Omezená detekce chyb
`strcpy`	`strcpy_s`, `StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`, `strlcpy`	Bez kontroly hranic
`strcpyA`	`strcpy_s`, `StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`, `strlcpy`	Bez kontroly hranic
`strncat`	`strncat_s`, `StringCbCatN`, `StringCbCatNEx`, `StringCchCatN`, `StringCchCatNEx`, `strlcat`	Omezená detekce chyb
`strncpy`	`strncpy_s`, `StringCbCopyN`, `StringCbCopyNEx`, `StringCchCopyN`, `StringCchCopyNEx`, `strlcpy`	Omezená detekce chyb
`swprintf`	`swprintf_s` `StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintf`, `StringCbPrintfEx`	Omezená detekce chyb
`ualstrcpyW`	`strcpy_s`, `StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`, `strlcpy`	Bez kontroly hranic
`vsnprintf`	`vsnprintf_s`, `StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Omezená detekce chyb
`vsprintf`	`vsprintf_s`, `StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`, `vasprintf`	Omezená detekce chyb
`vswprintf`	`vswprintf_s`
`wcscat`	`wcscat_s`, `StringCbCat`, `StringCbCatEx`, `StringCchCat`, `StringCchCatEx`, `wcslcat`	Omezená detekce chyb
`wcscpy`	`wcscpy_s`, `StringCbCopy`, `StringCbCopyEx`, `StringCchCopy`, `StringCchCopyEx`, `wcslcpy`	Bez kontroly hranic
`wcsncat`	`wcsncat_s`, `wcslcat`	Omezená detekce chyb
`wcsncpy`	`wcsncpy_s`, `StringCbCopyN`, `StringCbCopyNEx`, `StringCchCopyN`, `StringCchCopyNEx`, `wcslcpy`	Omezená detekce chyb
`wnsprintf`	`StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Bez ukončení pomocí NULL
`wnsprintfA`	`StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Bez ukončení s hodnotou NULL
`wsprintf`	`StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Bez ukončení s hodnotou NULL
`wsprintfA`	`StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Bez ukončení s hodnotou NULL
`wsprintfW`	`StringCbPrintf`, `StringCbPrintf_l`, `StringCbPrintf_lEx`, `StringCbPrintfEx`, `StringCchPrintf`, `StringCchPrintfEx`	Žádná NULL-terminace
`wvnsprintf`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Bez ukončení s hodnotou NULL
`wvnsprintfA`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Bez terminace NULL
`wvnsprintfW`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Žádné ukončení hodnotou NULL
`wvsprintf`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Bez zakončení NULL
`wvsprintfA`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Bez ukončení s hodnotou NULL
`wvsprintfW`	`StringCbVPrintf`, `StringCbVPrintf_l`, `StringCbVPrintf_lEx`, `StringCbVPrintfEx`, `StringCchVPrintf`, `StringCchVPrintf_l`, `StringCchVPrintf_lEx`, `StringCchVPrintfEx`	Bez ukončení s hodnotou NULL

Sdílet prostřednictvím

Upozornění C28719

Poznámky

Příklad

Zakázané funkce

Váš názor

Další materiály