_CrtSetDebugFillThreshold

Ruft ab oder ändert den Schwellenwert, der Pufferfüllungsverhalten debuggen steuert in, Funktionen.

size_t _CrtSetDebugFillThreshold(
   size_t _NewThreshold
);

Parameter

• newThreshold
  Neuer Schwellenwert.

Rückgabewert

Der vorherige Schwellenwert.

Hinweise

Die Debugversionen von einigen Sicherheit-erhöhte CRT-Funktionen füllen den Puffer aus, der darauf mit ein Sonderzeichen (0xFD) übergeben wird. Dies hilft, um Fälle zu suchen, in denen die unzulässige Größe an die Funktion übergeben wurde. Leider reduziert sich auch die Leistung. Zur Leistungssteigerung, verwenden Sie _CrtSetDebugFillThreshold um Pufferfüllung für die Puffer zu deaktivieren, die größer als der Schwellenwert liegen. Ein Schwellenwert von 0 deaktiviert ihn für alle Puffer.

Der Standardschwellenwert ist SIZE_T_MAX.

Im Folgenden eine Liste der betroffenen Funktionen.

• strcpy_s, wcscpy_s, _mbscpy_s

• strncpy_s, _strncpy_s_l, wcsncpy_s, _wcsncpy_s_l, _mbsncpy_s, _mbsncpy_s_l

• _mbsnbcpy_s, _mbsnbcpy_s_l

• strcat_s, wcscat_s, _mbscat_s

• strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l

• _mbsnbcat_s, _mbsnbcat_s_l

• _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

• _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l, _mbsnset_s, _mbsnset_s_l

• _mbsnbset_s, _mbsnbset_s_l

• _makepath_s, _wmakepath_s

• _splitpath_s, _wsplitpath_s

• _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l

• _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

• strerror_s, _strerror_s, _wcserror_s, __wcserror_s

• _itoa_s, _i64toa_s, _ui64toa_s, _itow_s, _i64tow_s, _ui64tow_s

• _ecvt_s

• _fcvt_s

• _gcvt_s

Anforderungen

Routine	Erforderlicher Header
_CrtSetDebugFillThreshold	<crtdbg.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Bibliotheken

Nur Debugversionen von C-Laufzeitbibliotheken.

Beispiel

// crt_crtsetdebugfillthreshold.cpp
// compile with: /MTd
#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
fd  ²
fd  ²
fd  ²
fd  ²
With buffer-filling off:
68  h
6f  o
77  w
64  d
79  y
00
00
00
00
00

.NET Framework-Entsprechung

Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.

Siehe auch

Referenz

Debugroutinen