ICorProfilerInfo::GetModuleInfo 方法

  • 發行項

根據模組 ID，傳回模組的檔案名稱和模組的父組件 ID。

語法

HRESULT GetModuleInfo(  
    [in]  ModuleID   moduleId,  
    [out] LPCBYTE    *ppBaseLoadAddress,  
    [in]  ULONG      cchName,  
    [out] ULONG      *pcchName,  
    [out, size_is(cchName), length_is(*pcchName)]  
          WCHAR      szName[] ,  
    [out] AssemblyID *pAssemblyId);

參數

moduleId
[in] 將被擷取資訊的模組 ID。

ppBaseLoadAddress
[out] 載入模組的基底位址。

cchName
[in] szName 傳回緩衝區的長度 (以字元為單位)。

pcchName
[out] 所傳回的模組檔案名稱之總字元長度的指標。

szName
[out] 呼叫端提供的寬字元緩衝區。 當方法傳回時，這個緩衝區會包含模組的檔案名稱。

pAssemblyId
[out] 模組父組件之 ID 的指標。

備註

若為動態模組，則 szName 參數為空字串，且基底位址為 0 (零)。

雖然只要有模組 ID 即可呼叫 GetModuleInfo 方法，但必須等到分析工具收到 ICorProfilerCallback::ModuleAttachedToAssembly 回呼，才有可用的父組件 ID。

當 GetModuleInfo 傳回時，您必須確認 szName 緩衝區的大小足以包含模組的完整檔案名稱。 若要這樣做，請比對 pcchName 指向的值和 cchName 參數。 如果 pcchName 指向大於 cchName 的值，請配置較大的 szName 緩衝區，並以較大的大小來更新 cchName，然後再次呼叫 GetModuleInfo。

或者，您也可以先使用長度為零的 szName 緩衝區來呼叫 GetModuleInfo，以取得正確的緩衝區大小。 接著您就可以將緩衝區大小設定為 pcchName 中傳回的值，並再次呼叫 GetModuleInfo。

規格需求

平台：請參閱系統需求。

標頭： CorProf.idl、CorProf.h

程式庫：CorGuids.lib

.NET Framework版本：自 2.0 起可用

另請參閱