ICorDebugILCode2::GetInstrumentedILMap 方法

  • 發行項

[.NET Framework 4.5.2 與更新版本提供支援]

將對應從分析工具檢測中繼語言 (IL) 位移傳回至此執行個體的原始方法 IL 位移。

語法

HRESULT GetInstrumentedILMap(  
   [in] ULONG32 cMap,  
   [out] ULONG32 *pcMap,  
   [out, size_is(cMap), length_is(*pcMap)] COR_IL_MAP map[]  
);

參數

cMap
[in] map 陣列的儲存體容量。 如需詳細資訊，請參閱＜備註＞一節。

pcMap
[out] 寫入至對應陣列的 COR_IL_MAP 值數目。

map
[out] COR_IL_MAP 值陣列，這些值提供從分析工具檢測 IL 對應至原始方法 IL 的相關資訊。

備註

如果分析工具藉由呼叫 ICorProfilerInfo::SetILInstrumentedCodeMap 方法來設定對應，偵錯工具可以呼叫此方法來擷取對應，以及在計算堆疊追蹤和變數存留期時，在內部使用對應。

如果 cMap 為 0，而 pcMap 為非 null，則 pcMap 會設為可用的 COR_IL_MAP 值數目。 如果 cMap 不是零，則代表 map 陣列的儲存體容量。 當方法傳回時，map 包含最多 cMap 個項目，而 pcMap 會設為實際寫入 map 陣列的 COR_IL_MAP 值數目。

如果 IL 未經檢測，或是分析工具未提供對應，此方法會傳回 S_OK，並將 pcMap 設為 0。

規格需求

平台：請參閱系統需求。

標頭：CorDebug.idl、CorDebug.h

程式庫：CorGuids.lib

.NET Framework版本：自 4.5.2 起可用

另請參閱