Função SetVirtualDiskInformation (virtdisk.h)

Define informações sobre um VHD (disco rígido virtual).

Sintaxe

DWORD SetVirtualDiskInformation(
  [in] HANDLE                 VirtualDiskHandle,
  [in] PSET_VIRTUAL_DISK_INFO VirtualDiskInfo
);

Parâmetros

[in] VirtualDiskHandle

Um identificador para o disco virtual aberto, que deve ter sido aberto usando o sinalizador VIRTUAL_DISK_ACCESS_METAOPS . Para obter informações sobre como abrir um disco virtual, consulte a função OpenVirtualDisk .

[in] VirtualDiskInfo

Um ponteiro para uma estrutura de SET_VIRTUAL_DISK_INFO válida.

Retornar valor

Status da solicitação.

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

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.

Comentários

A função SetVirtualDiskInformation falhará se o membro ParentFilePath for solicitado a ser definido, mas o sistema não puder resolve o caminho fornecido.

Definir as informações pai também fará com que os campos GUID e Carimbo de data/hora pai do filho sejam atualizados.

O disco virtual não pode ser anexado enquanto essa operação estiver em andamento.

O chamador deve ter READ|Acesso WRITE ao repositório de backup do disco virtual.

Requisitos

Confira também

Sobre o VHD

Referência de VHD