DismGetImageInfo 函数
返回一个 DismImageInfo 结构数组,它们描述了 .wim 或 .vhd 文件中的映像。
语法
HRESULT WINAPI DismGetImageInfo(
_In_ PCWSTR ImageFilePath,
_Out_ DismImageInfo **ImageInfo,
_Out_ UINT *Count
);
参数
ImageFilePath [in]
.wim 或 .vhd 文件的相对或绝对路径。
ImageInfo [out]
指向 DismImageInfo 结构数组地址的指针。
Count [out]
返回的 DismImageInfo 结构的数量。
返回值
如果成功,则返回 S_OK。
注解
DismImageInfo 结构数组由 DISM API 在堆上进行分配。
重要
你必须调用 DismDelete,传递 ImageInfo 指针,才能释放与 DismImageInfo 结构关联的资源。
示例
HRESULT hr = S_OK;
UINT* ImageInfoCount;
hr = DismGetImageInfo(L"C:\\Images\\Image1.vhd", &ImageInfo, &ImageInfoCount);
要求
要求 | 说明 |
---|---|
支持 .wim 映像的主机平台 | DISM API 可在 Windows 评估和部署工具包 (Windows ADK) 支持的任何操作系统上使用。 有关详细信息,请参阅 Windows ADK 技术参考。 |
支持 .vhd 映像的主机平台 | Windows 7、Windows Server 2008 R2、Windows 8、Windows Server 2012、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016 |
支持的映像平台 | Windows 7、Windows Server 2008 R2、Windows PE 3.0、Windows 8、Windows Server 2012、Windows 预安装环境 (Windows PE) 4.0、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016 |