estrutura OPEN_VIRTUAL_DISK_PARAMETERS (virtdisk.h)

Artigo
03/03/2024

Contém parâmetros de solicitação aberta de disco virtual.

Sintaxe

typedef struct _OPEN_VIRTUAL_DISK_PARAMETERS {
  OPEN_VIRTUAL_DISK_VERSION Version;
  union {
    struct {
      ULONG RWDepth;
    } Version1;
    struct {
      BOOL GetInfoOnly;
      BOOL ReadOnly;
      GUID ResiliencyGuid;
    } Version2;
  };
} OPEN_VIRTUAL_DISK_PARAMETERS, *POPEN_VIRTUAL_DISK_PARAMETERS;

Membros

Version

Uma enumeração OPEN_VIRTUAL_DISK_VERSION que especifica a versão da estrutura OPEN_VIRTUAL_DISK_PARAMETERS que está sendo passada de ou para as funções VHD.

Valor	Significado
OPEN_VIRTUAL_DISK_VERSION_1 1	Use o membro Version1 dessa estrutura.
OPEN_VIRTUAL_DISK_VERSION_2 2	Use o membro Version2 dessa estrutura.

Version1

Essa estrutura será usada se o membro Version for OPEN_VIRTUAL_DISK_VERSION_1 (1).

Version1.RWDepth

Indica o número de repositórios, começando com o filho, da cadeia de repositórios de backup para abrir como leitura/gravação. Os repositórios restantes na cadeia de diferenciação serão abertos somente leitura. Isso é necessário para que as operações de mesclagem tenham êxito.

Valor	Significado
0	Não abra para leitura/gravação em nenhuma profundidade. Esse valor deve ser usado para operações somente leitura.
OPEN_VIRTUAL_DISK_RW_DEPTH_DEFAULT 1	Valor padrão a ser usado se nenhum outro valor for desejado.
n (definido pelo usuário)	Esse valor inteiro deve ser o número de níveis de mesclagem mais um, se uma operação de mesclagem for destinada.

Version2

Essa estrutura será usada se o membro Version for OPEN_VIRTUAL_DISK_VERSION_2 (2).

Windows 7 e Windows Server 2008 R2: Essa estrutura não tem suporte até Windows 8 e Windows Server 2012.

Version2.GetInfoOnly

Se TRUE, indica que o identificador deve ser usado apenas para obter informações sobre o disco virtual.

Version2.ReadOnly

Se TRUE, indica que o repositório de backup de arquivos deve ser aberto como somente leitura.

Version2.ResiliencyGuid

GUID de resiliência a ser especificado ao abrir arquivos.

Observação

Os parâmetros a seguir precedidos de Version3 destinam-se ao uso interno.

Version3

Version3.GetInfoOnly

Version3.ReadOnly

Version3.ResiliencyGuid

Version3.SnapshotId

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

OpenVirtualDisk

Referência de VHD

Compartilhar via