Partilhar via


Função DismGetImageInfo

Retorna uma matriz de estruturas DismImageInfo que descrevem as imagens em um arquivo .wim ou .vhd.

Sintaxe

HRESULT WINAPI DismGetImageInfo(
  _In_  PCWSTR        ImageFilePath,
  _Out_ DismImageInfo **ImageInfo,
  _Out_ UINT          *Count
);

Parâmetros

ImageFilePath [in]
Um caminho relativo ou absoluto para um arquivo .wim ou .vhd.

ImageInfo [out]
Um ponteiro para o endereço de uma matriz de estruturas DismImageInfo .

Count [out]
O número de estruturas DismImageInfo retornadas.

Retornar valor

Retornará S_OK se houver êxito.

Comentários

A matriz de estruturas DismImageInfo é alocada pela API DISM no heap.

Importante

Você deve chamar DismDelete, passando o ponteiro ImageInfo , para liberar os recursos associados às estruturas DismImageInfo .

Exemplo

HRESULT hr = S_OK;
UINT* ImageInfoCount;
hr = DismGetImageInfo(L"C:\\Images\\Image1.vhd", &ImageInfo, &ImageInfoCount);

Requisitos

Requisito Descrição
Plataforma de host com suporte para imagens .wim A API DISM pode ser usada em qualquer sistema operacional compatível com o Windows ADK (Kit de Avaliação e Implantação). Para obter mais informações, confira a Referência técnica do Windows ADK.
Plataforma de host com suporte para imagens .vhd Windows 7, Windows Server 2008 R2, Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016
Plataformas de imagem com suporte Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows PE (Ambiente de Pré-Instalação do Windows) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016

Confira também

DismImageInfo

DismGetMountedImageInfo

DismMountedImageInfo

DismDelete