check_stack
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

check_stack

#pragma check_stack([ {on | off}] )
#pragma 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. 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

See Also

Pragma Directives

Show:
© 2016 Microsoft