SetThreadStackGuarantee

呼び出し側スレッドまたはファイバに関連するスタックの最小サイズを設定する。これはスタックオーバーフロー例外発生時に使用可能となる。

SetThreadStackGuarantee StackSizeInBytes

StackSizeInBytes : [var] スタックのサイズ（バイト単位）。戻り時にこの値は直前のスタックサイズに設定される。0 を指定した場合、関数は成功し、本パラメータには現在のスタックサイズが設定される。指定サイズが現在のサイズより小さい場合、関数は成功するがこの要求は無視される。したがって本関数でスタックサイズを縮小することはできない。予約済みスタックサイズを超える値は指定できない。

(プラグイン / モジュール : kernel32.dll)

解説

呼び出し側スレッドまたはファイバに関連するスタックの最小サイズを設定する。これはスタックオーバーフロー例外発生時に使用可能となる。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
関数が成功した場合、アプリケーションは構造化例外処理を使って EXCEPTION_STACK_OVERFLOW
例外を扱える。スタックオーバーフロー処理後に実行を再開するには、特定の復旧手順が必要である。Microsoft C/C++
コンパイラを使う場合は _resetstkoflw
関数を呼ぶ。他のコンパイラの場合はそのドキュメントを参照。ファイバのスタック保証を設定するには、まず SwitchToFiber
でファイバを実行する必要がある。設定後はどのスレッドがそのファイバを実行してもこの保証が使われる。

情報