Método IVdsAdvancedDisk::D eletePartition (vds.h)

Artigo
03/08/2023

[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.]

Exclui uma partição de um disco básico.

Sintaxe

HRESULT DeletePartition(
  [in] ULONGLONG ullOffset,
  [in] BOOL      bForce,
  [in] BOOL      bForceProtected
);

Parâmetros

[in] ullOffset

O deslocamento de partição.

[in] bForce

Se esse parâmetro for definido como TRUE, o VDS excluirá todas as partições incondicionalmente (excluindo OEM, ESP ou MSR). Se estiver definido como FALSE, a operação falhará se a partição estiver em uso. Uma partição será considerada em uso se as chamadas para bloquear ou desmontar o volume falharem.

[in] bForceProtected

Se esse parâmetro for definido como TRUE, o VDS excluirá todas as partições protegidas (incluindo OEM, ESP e MSR) incondicionalmente. Se estiver definido como FALSE, a operação falhará se a partição estiver protegida.

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 se originar 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	A partição foi excluída com êxito.
VDS_E_INVALID_OPERATION 0x80042415L	A mídia não dá suporte a essa operação. Por exemplo, você não pode excluir uma partição em um CD-ROM.
VDS_E_NOT_SUPPORTED 0x80042400L	Não há suporte para essa operação em discos dinâmicos.
VDS_E_PARTITION_NOT_EMPTY 0x80042408L	A partição estendida não está vazia.
VDS_E_BAD_PROVIDER_DATA 0x80042441L	Esse valor indica um erro de provedor. A operação foi anulada.
VDS_E_DEVICE_IN_USE 0x80042413L	A partição está em uso.
VDS_S_ACCESS_PATH_NOT_DELETED 0x00044244L	A partição foi excluída com êxito, mas o VDS não conseguiu remover os caminhos de acesso.
VDS_S_UPDATE_BOOTFILE_FAILED 0x00042434L	A partição foi excluída com êxito, mas o VDS não conseguiu atualizar as opções de inicialização no repositório BCD (Dados de Configuração de Inicialização). Windows Server 2003: As opções de inicialização são armazenadas no arquivo boot.ini em um sistema x86 ou x64 ou NVRAM em um sistema Itanium.

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

Objeto Disk

IVdsAdvancedDisk

Compartilhar via