SymSetContext 関数 (dbghelp.h)
SymEnumSymbols 関数で使用されるコンテキスト情報を設定します。 この関数は PDB シンボルでのみ機能します。
構文
BOOL IMAGEAPI SymSetContext(
[in] HANDLE hProcess,
[in] PIMAGEHLP_STACK_FRAME StackFrame,
[in, optional] PIMAGEHLP_CONTEXT Context
);
パラメーター
[in] hProcess
プロセスへのハンドル。 このハンドルは、 SymInitialize 関数に以前に渡されている必要があります。
[in] StackFrame
フレーム情報を含む IMAGEHLP_STACK_FRAME 構造体へのポインター。
[in, optional] Context
このパラメーターは無視されます。
戻り値
関数が成功した場合、戻り値は TRUE になります。
関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報を取得するには、 GetLastError を呼び出します。
注釈
SymSetContext を呼び出してコンテキストを現在の値に設定すると、関数は失敗しますが、GetLastError はERROR_SUCCESSを返します。
この関数など、すべての DbgHelp 関数はシングル スレッドです。 そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。 これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | dbghelp.h |
| Library | Dbghelp.lib |
| [DLL] | Dbghelp.dll |
| 再頒布可能パッケージ | DbgHelp.dll 5.1 以降 |