_CrtSetDebugFillThreshold

檢索或修改調試函數中控制緩衝區填充行為的閾值。

語法

size_t _CrtSetDebugFillThreshold( size_t newThreshold );

參數

newThreshold
新的閾值大小（以位元組為單位）。

返回值

上一個閾值。

備註

某些安全增強型 CRT 函數的調試版本使用特殊字元 （0xFE） 填充傳遞給它們的緩衝區。 用於填充的字元有助於尋找將錯誤大小傳遞給函數的情況。 不幸的是，它也降低了性能。 要提高性能，請使用 _CrtSetDebugFillThreshold 禁用大於 newThreshold 閾值的緩衝區填充。 值為 newThreshold 0 將對所有緩衝區禁用它。

預設閾值為 SIZE_T_MAX。

以下是受影響的函數清單：

• asctime_s、_wasctime_s
• _cgets_s、_cgetws_s
• ctime_s、、_ctime32_s_ctime64_s、_wctime_s、、_wctime32_s、_wctime64_s
• _ecvt_s
• _fcvt_s
• _gcvt_s
• _itoa_s， _ltoa_s， ， _ultoa_s， _i64toa_s， _ui64toa_s_itow_s_ltow_s_ultow_s_i64tow_s_ui64tow_s
• _makepath_s、_wmakepath_s
• _mbsnbcat_s、_mbsnbcat_s_l
• _mbsnbcpy_s、_mbsnbcpy_s_l
• _mbsnbset_s、_mbsnbset_s_l
• _mktemp_s、_wmktemp_s
• _splitpath_s、_wsplitpath_s
• strcat_s、wcscat_s、_mbscat_s
• strcpy_s、wcscpy_s、_mbscpy_s
• _strdate_s、_wstrdate_s
• strerror_s、 、 _strerror_s、 _wcserror_s__wcserror_s
• _strlwr_s、、_strlwr_s_l_mbslwr_s、_mbslwr_s_l、、_wcslwr_s、_wcslwr_s_l
• strncat_s、、_strncat_s_lwcsncat_s、_wcsncat_s_l、、_mbsncat_s、_mbsncat_s_l
• strncpy_s、、_strncpy_s_lwcsncpy_s、_wcsncpy_s_l、、_mbsncpy_s、_mbsncpy_s_l
• _strnset_s、、_strnset_s_l_wcsnset_s、_wcsnset_s_l、、_mbsnset_s、_mbsnset_s_l
• _strset_s、、_strset_s_l_wcsset_s、_wcsset_s_l、、_mbsset_s、_mbsset_s_l
• _strtime_s、_wstrtime_s
• _strupr_s、、_strupr_s_l_mbsupr_s、_mbsupr_s_l、、_wcsupr_s、_wcsupr_s_l
• vsnprintf_s、_vsnprintf_s、_vsnprintf_s_l、_vsnwprintf_s、_vsnwprintf_s_l

需求

常規	必要的標頭
_CrtSetDebugFillThreshold	<crtdbg.h>

此函數特定於 Microsoft。 如需相容性詳細資訊，請參閱相容性。

圖書館

僅調試 C 運行時庫 的版本。

範例

// crt_crtsetdebugfillthreshold.c
// compile with: cl /MTd crt_crtsetdebugfillthreshold.c
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <crtdbg.h>

void Clear( char buff[], size_t size )
{
   for( int i=0; i<size; ++i )
      buff[i] = 0;
}

void Print( char buff[], size_t size )
{
   for( int i=0; i<size; ++i )
      printf( "%02x  %c\n", (unsigned char)buff[i], buff[i] );
}

int main( void )
{
   char buff[10];

   printf( "With buffer-filling on:\n" );
   strcpy_s( buff, _countof(buff), "howdy" );
   Print( buff, _countof(buff) );

   _CrtSetDebugFillThreshold( 0 );

   printf( "With buffer-filling off:\n" );
   Clear( buff, _countof(buff) );
   strcpy_s( buff, _countof(buff), "howdy" );
   Print( buff, _countof(buff) );
}

With buffer-filling on:
68  h
6f  o
77  w
64  d
79  y
00
fe  ■
fe  ■
fe  ■
fe  ■
With buffer-filling off:
68  h
6f  o
77  w
64  d
79  y
00
00
00
00
00

另請參閱

調試例程