_CrtSetDebugFillThreshold

在调试函数中检索或修改控制缓冲区填充行为的阈值。

语法

size_t _CrtSetDebugFillThreshold( size_t newThreshold );

参数

newThreshold
新阈值大小（以字节为单位）。

返回值

以前的阈值。

注解

某些安全性增强了的 CRT 函数的调试版本将使用特殊字符 (0xFE) 来填充传递给它们的缓冲区。 填充字符有助于查找为函数传递错误大小的情况。 遗憾的是，这样也会降低性能。 若要提高性能，可对大于 newThreshold 阈值的缓冲区使用 _CrtSetDebugFillThreshold 来禁止填充缓冲区。 如果 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_l、wcsncat_s、_wcsncat_s_l、_mbsncat_s、_mbsncat_s_l

• strncpy_s、_strncpy_s_l、wcsncpy_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

要求

例程	必需的标头
_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

另请参阅

调试例程