Função EnumerateVirtualDiskMetadata (virtdisk.h)

  • Artigo

Enumera os metadados associados a um disco virtual.

Sintaxe

DWORD EnumerateVirtualDiskMetadata(
  [in]      HANDLE VirtualDiskHandle,
  [in, out] PULONG NumberOfItems,
  [out]     GUID   *Items
);

Parâmetros

[in] VirtualDiskHandle

Manipule para um disco virtual aberto.

[in, out] NumberOfItems

Endereço de um ULONG. Na entrada, o valor indica o número de elementos no buffer apontado pelo parâmetro Items . Na saída, o valor contém o número de itens recuperados. Se o buffer for muito pequeno, a API falhará e retornará ERROR_INSUFFICIENT_BUFFER e o ULONG conterá o tamanho do buffer necessário.

[out] Items

Endereço de um buffer a ser preenchido com os GUIDs que representam os metadados. A função GetVirtualDiskMetadata pode ser usada para recuperar os dados representados por cada GUID.

Retornar valor

Status da solicitação.

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se o buffer apontado pelo parâmetro Items for muito pequeno, o valor retornado será ERROR_INSUFFICIENT_BUFFER.

Se a função falhar, o valor retornado será um código de erro. Para obter mais informações, consulte Códigos de erro do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho virtdisk.h (inclua Windows.h)
Biblioteca VirtDisk.lib
DLL VirtDisk.dll

Confira também

Funções VHD