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 |
| 程式庫 | Dbghelp.lib |
| Dll | Dbghelp.dll |
| 可轉散發套件 | DbgHelp.dll 5.1 或更新版本 |