Share via

警告 C28726

  • 發行項

禁用 API 使用方式：『*function-name』 不安全，且已標示為已被取代。

這個警告表示正在使用已禁用且更強固或更安全的取代函式。 這個特定錯誤表示禁用函式可能會溢位緩衝區。

備註

此錯誤涵蓋的所有禁用函式清單、為何禁用，以及下列範例之後可以找到建議的取代專案。

程式代碼分析名稱：BANNED_API_USAGEL2

範例

下列程式代碼會產生此警告：

void example_func() 
{ 
    char user_input[10]; 
    scanf(“%s”, input); // scanf is banned for security purposes 
}

這是因為使用 unsafe 函 scanf式 。 scanf 會限制複製到緩衝區的數據大小。 若要修正此問題，我們可以使用 scanf_s，更安全地取代此函式。 scanf_s 需要開發人員指定要複製的位元組數目。 scanf_s 只會確保會複製許多位元組。 例如，下列程式代碼更安全：

void example_func() 
{ 
    char user_input[10]; 
    scanf_s(“%9s”, input, sizeof(input)); // 9 bytes leaves room for the \0 byte at the end  
}

禁用函式

注意：此清單正在積極更新和改善

禁用 API 取代 (s) 合理性 / 附注
_itoa _itoa_s 不會以 NULL 終止
_i64toa _i64toa_s 不會以 NULL 終止
_i64tow _i64tow_s 不會以 NULL 終止
_mbccpy _mbccpy_s
_mbscpy _mbscpy_s
_mbsnbcpy _mbsnbcpy_s
_mbsnbcat _mbsnbcat_s
_mbsncat _mbsncat_s
_mbsncpy _mbsncpy_s
_mbstok _mbstok_s
_snscanf _snscanf_s
_snwscanf _snwscanf_s
_ui64toa ui64toa_s
_ui64tow _ui64tow_s
_ultoa _ultoa_s
CharToOemA
CharToOemBuffA
CharToOemBuffW
CharToOemW
OemToCharA
OemToCharBuffA
OemToCharBuffW
scanf scanf_s 有限的錯誤偵測
sscanf sscanf_s 有限的錯誤偵測
wmemcpy wmemcpy_s 有限的錯誤偵測
wnsprintfW
wscanf wscanf_s