Função SetVirtualDiskInformation (virtdisk.h)

  • Artigo

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

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho virtdisk.h
Biblioteca VirtDisk.lib
DLL VirtDisk.dll

Confira também

Sobre o VHD

Referência de VHD