Compartilhar via


Função GetVirtualDiskMetadata (virtdisk.h)

Recupera os metadados especificados do disco virtual.

Sintaxe

DWORD GetVirtualDiskMetadata(
  [in]      HANDLE     VirtualDiskHandle,
  [in]      const GUID *Item,
  [in, out] PULONG     MetaDataSize,
  [out]     PVOID      MetaData
);

Parâmetros

[in] VirtualDiskHandle

Manipule para um disco virtual aberto.

[in] Item

Endereço de um GUID que identifica os metadados a serem recuperados.

[in, out] MetaDataSize

Endereço de um ULONG. Na entrada, o valor indica o tamanho, em bytes, do buffer apontado pelo parâmetro MetaData . Na saída, o valor contém o tamanho, em bytes, dos metadados recuperados. Se o buffer for muito pequeno, a API falhará e retornará ERROR_INSUFFICIENT_BUFFER, colocando o tamanho necessário no ULONG e o buffer conterá o início dos metadados.

[out] MetaData

Endereço do buffer em que os metadados devem ser armazenados.

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