estrutura SET_VIRTUAL_DISK_INFO (virtdisk.h)

  • Artigo

Contém informações de VHD (disco rígido virtual) a serem usadas quando você chama a função SetVirtualDiskInformation para definir propriedades VHD.

Sintaxe

typedef struct _SET_VIRTUAL_DISK_INFO {
  SET_VIRTUAL_DISK_INFO_VERSION Version;
  union {
    PCWSTR ParentFilePath;
    GUID   UniqueIdentifier;
    struct {
      ULONG  ChildDepth;
      PCWSTR ParentFilePath;
    } ParentPathWithDepthInfo;
    ULONG  VhdPhysicalSectorSize;
    GUID   VirtualDiskId;
    BOOL   ChangeTrackingEnabled;
    struct {
      GUID   LinkageId;
      PCWSTR ParentFilePath;
    } ParentLocator;
  };
} SET_VIRTUAL_DISK_INFO, *PSET_VIRTUAL_DISK_INFO;

Membros

Version

Uma enumeração SET_VIRTUAL_DISK_INFO_VERSION que especifica a versão da estrutura SET_VIRTUAL_DISK_INFO que está sendo passada de ou para as funções VHD. Isso determina o tipo de conjunto de informações.

ParentFilePath

O caminho para o repositório de backup pai. Defina o membro Version como SET_VIRTUAL_DISK_INFO_PARENT_PATH (1).

UniqueIdentifier

O identificador exclusivo do VHD. Defina o membro Version como SET_VIRTUAL_DISK_INFO_IDENTIFIER (2).

ParentPathWithDepthInfo

Define o caminho do arquivo pai e a profundidade filho. Defina o membro Versioncomo SET_VIRTUAL_DISK_INFO_PARENT_PATH_WITH_DEPTH (3).

Windows 7 e Windows Server 2008 R2: Não há suporte para isso antes de Windows 8 e Windows Server 2012.

ParentPathWithDepthInfo.ChildDepth

Especifica a profundidade para o filho da folha. A folha em si está na profundidade 1.

ParentPathWithDepthInfo.ParentFilePath

Especifica a profundidade para o pai da folha. A folha em si está na profundidade 1.

VhdPhysicalSectorSize

Define o tamanho do setor físico relatado pelo VHD. Defina o membro Versioncomo SET_VIRTUAL_DISK_INFO_PHYSICAL_SECTOR_SIZE (4). Windows 7 e Windows Server 2008 R2: Não há suporte para isso antes de Windows 8 e Windows Server 2012.

VirtualDiskId

O identificador criado exclusivamente quando um usuário cria o disco virtual pela primeira vez para tentar identificar exclusivamente esse disco virtual. Defina o membro Version como SET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID (5).

Windows 8 e Windows Server 2012: não há suporte para isso antes Windows 8.1 e Windows Server 2012 R2.

ChangeTrackingEnabled

Ativa ou desativa o RCT (controle de alterações resiliente) para o VHD. TRUE ativa o RCT. FALSE desativa o RCT. Defina o membro Versioncomo SET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE (6).

Windows 8.1 e Windows Server 2012 R2: esse membro não tem suporte antes de Windows 10 e Windows Server 2016.

ParentLocator

Define as informações de vinculação pai que diferem o repositório de VHDs. As informações de vinculação pai são metadados usados para localizar e identificar corretamente o próximo pai na cadeia de disco virtual. Defina o membro Version como SET_VIRTUAL_DISK_INFO_PARENT_LOCATOR (7).

Windows 8.1 e Windows Server 2012 R2: esse membro não tem suporte antes de Windows 10 e Windows Server 2016.

ParentLocator.LinkageId

O identificador exclusivo para as informações de vinculação pai.

ParentLocator.ParentFilePath

O caminho do arquivo para o VHD pai.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Cabeçalho virtdisk.h

Confira também

Sobre o VHD

Referência de VHD