取得指定位址的名稱。
注意
此 API 原先是為了在執行階段內部使用而設計的。 雖然現在支援第三方使用,但建議您盡量優先採用 ICorDebug 與 ICorProfiler API。
語法
HRESULT GetRuntimeNameByAddress(
[in] CLRDATA_ADDRESS address,
[in] ULONG32 flags,
[in] ULONG32 bufLen,
[out] ULONG32 *nameLen,
[out, size_is(bufLen)] WCHAR nameBuf[],
[out] CLRDATA_ADDRESS* displacement
);
參數
address
[in] 表示程式碼位址的 CLRDATA_ADDRESS 值。
flags
[in] 設為「0」。
bufLen
[in] 緩衝區的長度。
namLen
[out] 傳回字元數目的指標。
namBuf
[out, size_is(bufLen)] 儲存執行時間名稱的輸入緩衝區長度 bufLen。
displacement
[out] 傳回符號的程式碼位移 CLRDATA_ADDRESS 指標。
備註
提供的方法是 IXCLRDataProcess 介面的一部分,並對應至虛擬方法資料表的第 16 個位置。
注意
如果緩衝區不足以儲存名稱,這個方法會傳回 S_FALSE 並將 nameLen 設為所需的緩衝區長度。
規格需求
平台:請參閱系統需求
標頭:無
程式庫:無
.NET Framework版本:自 4.7 起可用