Share via

estrutura CHANGE_ATTRIBUTES_PARAMETERS (vds.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define os parâmetros de partição de um estilo de partição.

Sintaxe

typedef struct _CHANGE_ATTRIBUTES_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      ULONGLONG attributes;
    } GptPartInfo;
  };
} CHANGE_ATTRIBUTES_PARAMETERS;

Membros

style

Determina os parâmetros de partição. Os valores com suporte são VDS_PST_MBR ou VDS_PST_GPT.

MbrPartInfo

Usado se o estilo for VDS_PST_MBR. Parâmetros para um disco de registro mestre de inicialização (MBR).

MbrPartInfo.bootIndicator

Se TRUE, a partição estará ativa e poderá ser inicializada; caso contrário, a partição não pode ser usada para inicializar o sistema.

GptPartInfo

Usado se o estilo for VDS_PST_GPT. Parâmetros para um disco DE TABELA de Partição GUID (GPT).

GptPartInfo.attributes

Atributos da partição. Esse valor pode ser um ou mais dos seguintes:

Valor Significado
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
 Se esse atributo for definido, a partição será exigida por um computador para funcionar corretamente.

Por exemplo, esse atributo deve ser definido para partições OEM. Observe que, se esse atributo estiver definido, você poderá usar o utilitário DiskPart.exe para executar operações de partição, como excluir a partição. No entanto, como a partição não é um volume, você não pode usar o utilitário DiskPart.exe para executar operações de volume na partição.

Esse atributo pode ser definido para discos básicos e dinâmicos. Se ele for definido para uma partição em um disco básico e o disco for convertido em um disco dinâmico, a partição permanecerá uma partição básica, mesmo que o restante do disco seja um disco dinâmico. Isso ocorre porque a partição é considerada uma partição OEM em um disco GPT.
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
 Se esse atributo for definido, a partição não receberá uma letra da unidade por padrão quando o disco for movido para outro computador ou o disco for visto pela primeira vez por um computador.

Esse atributo é útil em ambientes SAN.

Apesar do nome, esse atributo pode ser definido para discos básicos e dinâmicos.
GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
 Se esse atributo for definido, a partição não será detectada pelo Gerenciador de Montagem.

Como resultado, a partição não recebe uma letra da unidade, não recebe um caminho GUID de volume, não hospeda pastas montadas (também chamadas de pontos de montagem de volume) e não é enumerada por chamadas para FindFirstVolume e FindNextVolume. Isso garante que aplicativos como o Desfragmentador de Disco não acessem a partição. O VSS (Serviço de Cópias de Sombra de Volume) usa esse atributo.

Apesar do nome, esse atributo pode ser definido para discos básicos e dinâmicos.
GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
 Se esse atributo for definido, a partição será uma cópia de sombra de outra partição.

Esse atributo é usado pelo VSS (Serviço de Cópia de Sombra de Volume). Esse atributo é uma indicação para o software baseado em driver de filtro do sistema de arquivos (como programas antivírus) para evitar a anexação ao volume.

Um aplicativo pode usar o atributo para diferenciar um volume de cópia de sombra de um volume de produção. Um aplicativo que executa uma recuperação rápida, por exemplo, interromperá um LUN de cópia de sombra limpando os atributos somente leitura e ocultos e esse atributo. Esse atributo é definido quando a cópia de sombra é criada e desmarcada quando a cópia de sombra é interrompida.

Apesar do nome, esse atributo pode ser definido para discos básicos e dinâmicos.

Windows Server 2003: Não há suporte para esse atributo antes do Windows Server 2003 com SP1.
GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
 Se esse atributo for definido, a partição será somente leitura.

Todas as solicitações para gravar na partição falharão. IOCTL_DISK_IS_WRITABLE falhará com o código de erro ERROR_WRITE_PROTECT Win32, o que fará com que o sistema de arquivos seja montado como somente leitura, se um sistema de arquivos estiver presente.

O VSS usa esse atributo.

Não defina esse atributo para discos dinâmicos. Defini-lo pode causar erros de E/S e impedir que o sistema de arquivos seja montado corretamente.

Comentários

O método IVdsAdvancedDisk::ChangeAttributes usa essa estrutura como um parâmetro.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho vds.h

Confira também

IVdsAdvancedDisk::ChangeAttributes

Estruturas VDS