要求调试器返回模块的完整路径,该模块的元数据是完成调试器请求的作所必需的。
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]写入到wszPathBuffer的WCHAR计数。
如果方法返回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 起可用