共用方式為

IDebugAdvanced2：：GetSymbolInformation 方法 （dbgeng.h）

  • 發行項

GetSymbolInformation 方法會傳回符號的指定資訊。

語法

HRESULT GetSymbolInformation(
  [in]            ULONG   Which,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize,
  [out, optional] PSTR    StringBuffer,
  [in]            ULONG   StringBufferSize,
  [out, optional] PULONG  StringSize
);

參數

[in] Which

指定要傳回的資訊片段。 下清單格中的其中一個值。

價值 傳回的資訊
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE 傳回指定斷點的原始程式碼檔名和行號。 行號會以ULONG傳回至 Buffer。 檔案名會傳回至 StringBuffer。
DEBUG_SYMINFO_IMAGEHLP_MODULEW64 傳回描述指定模組的IMAGEHLP_MODULEW64結構。 如需此結構的詳細資訊，請參閱偵錯說明連結庫檔 （dbghelp.chm） 中的IMAGEHLP_MODULE64主題。

不會傳回任何字串，StringBuffer、StringBufferSize，而且 StringSize 都必須全部設定為零。
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE 傳回記憶體和 PDB 標記類型中位置所指定符號的 Unicode 名稱。 名稱會傳回給 buffer 。 未使用 StringBuffer。
DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS 傳回指定模組中具有指定 PDB 標籤型態的符號名稱和位移清單。 位移會以 ULONG 值的陣列傳回，以 Buffer。 名稱會以與 stringBuffer 位移相同的順序傳回。 某些名稱可能包含內嵌零，因為批注可以有多個部分名稱;因此，每個名稱都會以兩個 Null 字元終止。

[in] Arg64

指定64位自變數。 此參數具有下列解譯，視 的值而定：

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

忽視。

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

要求其描述之模組的基位址。

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

指定目標記憶體中要求名稱之符號的位址。

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

指定要求符號的模組。 Arg64 是模組記憶體配置內的位置。

[in] Arg32

指定32位自變數。 此參數具有下列解譯，視 的值而定：

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

所需斷點的引擎斷點標識碼。

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

設定為零。

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

符號的 PDB 分類。 Arg32 必須是 Dbghelp.h 中定義的 SymTagEnum 列舉中的其中一個值。 如需詳細資訊，請參閱 PDB 檔。

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

符號的 PDB 分類。 Arg32 必須是 Dbghelp.h 中定義的 SymTagEnum 列舉中的其中一個值。 如需詳細資訊，請參閱 PDB 檔。

[out, optional] Buffer

接收要求的符號資訊。 傳回之數據類型取決於 的值。 如果 緩衝區NULL，則不會傳回此資訊。

[in] BufferSize

指定緩衝區的大小，以位元組為單位，Buffer。

[out, optional] InfoSize

如果這個方法傳回 S_OK，InfoSize 會接收傳回給 Buffer符號資訊的大小，以位元組為單位。 如果這個方法傳回 S_FALSE，則提供的緩衝區不夠大，而且 InfoSize 接收所需的緩衝區大小。 如果 InfoSizeNULL，則不會傳回此資訊。

[out, optional] StringBuffer

接收要求的字串。 此字串的解譯取決於 的值。 如果 StringBufferNULL，則不會傳回此資訊。

[in] StringBufferSize

指定字串緩衝區的大小，以字元為單位，StringBuffer。

[out, optional] StringSize

接收傳回給 stringBuffer 字串的大小，以字元為單位，。 如果 StringSizeNULL，則不會傳回此資訊。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值。

傳回碼 描述
S_OK
 方法成功。
S_FALSE
 方法成功。 不過，資訊不適用於緩衝區 Buffer，或字串無法放入緩衝區 StringBuffer，因此資訊或名稱已截斷。

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）