要求调试器返回模块的完整路径,该模块的元数据是完成调试器请求的作所必需的。
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 起可用