共用方式為


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 [在]以 Null 結尾的字串,代表檔案的完整路徑。 如果完整路徑無法使用,則檔案的名稱和副檔名 (filename.擴展)。

dwImageTimeStamp [在]映像 PE 檔案標頭的時間戳記。 此參數可能用於符號伺服器 (SymSrv) 查閱。

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

cchPathBuffer [在]中的 wszPathBuffer字元數。

pcchPathBuffer[出]寫給 wszPathBuffer的 s 的WCHAR計數。

如果方法傳回E_NOT_SUFFICIENT_BUFFER,則包含儲存路徑所需的 s 計 WCHAR數。

wszPathBuffer [出]緩衝區的指標,偵錯工具會將包含要求中繼資料之檔案的完整路徑複製到其中。

ofReadOnly CorOpenFlags 列舉中的旗標可用來要求此檔案中中繼資料的唯讀存取權。

傳回值

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

HRESULT Description
S_OK 方法已順利完成。 wszPathBuffer 包含檔案的完整路徑,且以 Null 結尾。
E_NOT_SUFFICIENT_BUFFER wszPathBuffer 當前大小不足以容納完整路徑。 在此情況下,包含 pcchPathBuffer 所需的 s 計數 WCHAR,包括終止 Null 字元,並 GetMetaData 以要求的緩衝區大小第二次呼叫。

備註

如果包含傾印中模組的完整路徑,則 wszImagePath 會指定收集傾印之電腦的路徑。 該檔案可能不存在於此位置,或者路徑上可能儲存了具有相同名稱的不正確檔案。

需求

平台: 請參閱 .NET 支援的作業系統

標題: CorDebug.idl、CorDebug.h

圖書館: CorGuids.lib

.NET 版本: 自 .NET Framework 4.0 起可用

另請參閱