關於 Strsafe.h

不良的緩衝區處理牽涉到涉及緩衝區滿溢的許多安全性問題。 Strsafe.h 中定義的函式會為程式代碼中的適當緩衝區處理提供額外的處理。 因此，它們的目的是要取代其內建 C/C++對應專案，以及特定的 Windows 實作。 從 Windows XP 搭配 Service Pack 2 （SP2） 開始，Windows SDK 中提供 Strsafe.h。

Strsafe 函式的優點包括：

• 目的地緩衝區的大小一律會提供給函式，以確保函式不會寫入緩衝區結尾。

• 即使作業截斷預定的結果，緩衝區仍保證為 Null 終止。

• 所有函式都會傳回 HRESULT 值，只有一個可能的成功程式代碼（S_OK）。

• 每個函式都可在對應的字元計數 （“cch”） 或位元組計數 （“cb”） 版本中取得。

• 大部分的函式都有適用於進階功能的擴充版 （“Ex”） 版本。

如需詳細資訊，請參閱下列各節。

• 字元計數函式
• 位元組計數函式
• 使用 Strsafe.h
• 相關主題

字元計數函式

下列函式會使用字元計數，而不是位元組計數。

函式	取代
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	取得、_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

 

位元組計數函式

下列函式會使用位元組計數，而不是字元計數。

函式	取代
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	取得、_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

 

使用 Strsafe.h

• 若要使用內嵌的 Strsafe 函式，請遵循所有其他頭檔 #include 語句，包含頭檔，如下所示。

  #include <strsafe.h>

• 若要在連結庫窗體中使用函式，請先包含下列語句，再包含 Strsafe.h。 不過，建議您使用內嵌函式。

  #define STRSAFE_LIB

  注意

  ：下列函式必須作為內嵌函式使用：StringCbGets、StringCbGetsEx、StringCchGets 和 StringCchGetsEx。

   

• 當您在檔案中包含 Strsafe.h 時，由 Strsafe.h 函式取代的較舊函式將會淘汰。 嘗試使用這些較舊的函式會導致編譯程序錯誤，告知您使用較新的函式。 如果您想要覆寫此行為，請先包含下列語句，再包含 Strsafe.h。

  #define STRSAFE_NO_DEPRECATE

• 若要只允許字元計數函式，請在包含 Strsafe.h 之前包含下列語句。

  #define STRSAFE_NO_CB_FUNCTIONS

• 若要只允許位元組計數函式，請在包含 Strsafe.h 之前包含下列語句。

  #define STRSAFE_NO_CCH_FUNCTIONS

  注意

  您可以定義STRSAFE_NO_CB_FUNCTIONS或STRSAFE_NO_CCH_FUNCTIONS，但不能同時定義兩者。

   

• 某些 Strsafe 函式具有地區設定感知版本。 根據預設，標頭不會宣告這些函式。 若要啟用這些宣告，請先包含下列巨集語句，再包含 Strsafe.h。

  #define STRSAFE_LOCALE_FUNCTIONS

• 支援的字串長度上限為 2,147,483,64 STRSAFE_MAX_CCH 7 個字元，即 ANSI 或 Unicode。

相關主題

Strsafe 函式