共用方式為

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 或更新版本

另請參閱

DbgHelp 函式

IMAGEHLP_STACK_FRAME

SymEnumSymbols