Share via

Método IVdsPack::AddDisk (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.]

Adiciona um disco a um pacote online.

Sintaxe

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

Parâmetros

[in] DiskId

O GUID do disco.

[in] PartitionStyle

O estilo pode ser MBR ou GPT. Consulte a enumeração VDS_PARTITION_STYLE .

[in] bAsHotSpare

Se for true, o VDS poderá usar o disco como um sobressalente ativo; caso contrário, o disco não pode ser usado para esta operação. Somente os provedores de hardware dão suporte à moderação dinâmica.

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Valor/código retornado Descrição
S_OK
 O disco foi adicionado com êxito.
VDS_E_NOT_AN_UNALLOCATED_DISK
0x80042418L
 O disco é bruto.
VDS_E_OPERATION_DENIED
0x8004240AL
 O disco a ser adicionado está sendo limpo.
VDS_E_PROVIDER_FAILURE
0x80042442L
 Há uma falha de provedor durante a operação.
VDS_E_NOT_SUPPORTED
0x80042400L
 Não há suporte para a adição de um segundo disco a um pacote básico.
VDS_E_PACK_OFFLINE
0x80042444L
 O pacote de destino está inacessível.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 O disco não foi encontrado.
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
 O serviço LDM (gerenciador de disco lógico) não pôde concluir um método.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 O cache do provedor dinâmico está corrompido.

Comentários

O VDS implementa esse método.

Esse método inicializa um disco bruto (um disco que não tem particionamento definido) e o adiciona ao pacote. Antes que esse método seja chamado, o disco bruto pertence ao serviço VDS. Depois que esse método retorna, o disco pertence ao provedor básico.

Para desfazer o efeito desse método, ou seja, remover o formato de particionamento e fazer com que o disco seja um disco bruto que pertence ao serviço VDS, use o método IVdsAdvancedDisk::Clean .

Você não pode usar AddDisk para redefinir o particionamento em um disco existente.

Se você adicionar um disco GPT a um pacote básico, a operação criará automaticamente uma partição MSR no disco. Os dispositivos que executam o sistema operacional WinPE são a exceção porque um administrador pode preferir criar uma partição ESP no disco. A partição ESP, se presente, deve ser a primeira partição no disco.

Se você adicionar o disco a um pacote dinâmico, a operação não criará uma partição MSR.

Requisitos

Requisito Valor
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]
Plataforma de Destino Windows
Cabeçalho vds.h
Biblioteca Uuid.lib

Confira também

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE