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

另请参阅

DismImageInfo

DismGetMountedImageInfo

DismMountedImageInfo

DismDelete