ICorDebugMetaDataLocator::GetMetaData 方法

要求调试器返回模块的完整路径,该模块的元数据是完成调试器请求的作所必需的。

Syntax

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 结尾的字符串,表示文件的完整路径。 如果完整路径不可用,则文件的名称和扩展名(文件名)。扩展)。

dwImageTimeStamp [in]映像 PE 文件标头中的时间戳。 此参数可用于符号服务器(SymSrv)查找。

dwImageSize [in]PE 文件标头中的图像大小。 此参数可用于 SymSrv 查找。

cchPathBuffer[in]字符计数。wszPathBuffer

pcchPathBuffer[out]写入到wszPathBufferWCHAR计数。

如果方法返回E_NOT_SUFFICIENT_BUFFER,则包含存储路径所需的计数 WCHAR

wszPathBuffer [out]指向缓冲区的指针,调试器将复制包含所请求元数据的文件的完整路径。

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 起可用

另请参阅