Функция 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 выделяется API DISM в куче.
Важно!
Необходимо вызвать DismDelete, передав указатель ImageInfo , чтобы освободить ресурсы, связанные со структурами DismImageInfo .
Пример
HRESULT hr = S_OK;
UINT* ImageInfoCount;
hr = DismGetImageInfo(L"C:\\Images\\Image1.vhd", &ImageInfo, &ImageInfoCount);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемая платформа узла для WIM-образов | API DISM можно использовать в любой операционной системе, поддерживаемой пакетом средств оценки и развертывания 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 |