共用方式為

ICorDebugMetaDataLocator::GetMetaData 方法

  • 發行項

要求偵錯工具傳回完整路徑到模組，其需要中繼資料以完成偵錯工具的要求。

語法

HRESULT GetMetaData(
      [in] LPCWSTR wszImagePath,
      [in] DWORD   dwImageTimeStamp,
      [in] DWORD   dwImageSize,
      [in] ULONG32 cchPathBuffer,
      [out] ULONG32 * pcchPathBuffer,
      [out, size_is(cchPathBuffer), length_is(*pcchPathBuffer)]
               WCHAR wszPathBuffer[]
      );

參數

wszImagePath [in]Null 終止的字串，表示檔案的完整路徑。 如果完整路徑無法使用，則檔案的名稱和擴展名（檔名。extension）。

dwImageTimeStamp [in]映射PE檔案標頭中的時間戳。 此參數可用於符號伺服器 （SymSrv） 查閱。

dwImageSize [in]PE 檔案標頭中的影像大小。 此參數可能會用於 SymSrv 查閱。

cchPathBuffer [in]中的 wszPathBuffer字元計數。

pcchPathBuffer[out]寫入 至wszPathBuffer的WCHAR計數。

如果此方法會傳回 E_NOT_SUFFICIENT_BUFFER，包含 WCHAR 的計數需要儲存路徑。

wszPathBuffer [out]緩衝區的指標，調試程式會複製包含所要求元數據之檔案的完整路徑。

ofReadOnly CorOpenFlags 列舉中的旗標可用來要求此檔案中元數據的唯讀存取權。

傳回值

這個方法會傳回下列特定的 HRESULT，以及表示方法失敗的 HRESULT 錯誤。 所有其他失敗的 HRESULT 表示無法擷取檔案。

HRESULT 描述
S_OK 已成功完成命令。 wszPathBuffer 包含檔案的完整路徑，而且是以 null 結束。
E_NOT_SUFFICIENT_BUFFER 目前的大小 wszPathBuffer 不足以保存完整路徑。 在此情況下， pcchPathBuffer 包含所需的 WCHAR 計數，包括結束的 null 字元且 GetMetaData 被稱為第二次的要求緩衝區大小。

備註

如果 wszImagePath 包含來自傾印的模組完整路徑，它會指定從收集傾印所在之電腦的路徑。 檔案可能不存在這個位置，或具有相同名稱的不正確檔案可能儲存在路徑上。

需求

平台：請參閱系統需求。

標頭：CorDebug.idl、CorDebug.h

程式庫：CorGuids.lib

.NET Framework 版本： 自 4 起提供

另請參閱