check_stack
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at check_stack. Instructs the compiler to turn off stack probes if off (or –) is specified, or to turn on stack probes if on (or +) is specified.
Syntax
#pragma check_stack([ {on | off}] )
#pragma check_stack{+ | –}
Remarks
If no argument is given, stack probes are treated according to the default. This pragma takes effect at the first function defined after the pragma is seen. Stack probes are neither a part of macros nor of functions that are generated inline.
If you don't give an argument for the check_stack pragma, stack checking reverts to the behavior specified on the command line. For more information, see Compiler Reference. The interaction of the #pragma check_stack and the /Gs option is summarized in the following table.
Using the check_stack Pragma
| Syntax | Compiled with /Gs option? |
Action |
|---|---|---|
| #pragma check_stack( ) or #pragma check_stack |
Yes | Turns off stack checking for functions that follow |
| #pragma check_stack( ) or #pragma check_stack |
No | Turns on stack checking for functions that follow |
| #pragma check_stack(on) or #pragma check_stack + |
Yes or No | Turns on stack checking for functions that follow |
| #pragma check_stack(off) or #pragma check_stack – |
Yes or No | Turns off stack checking for functions that follow |