Método IVdsAdvancedDisk::CreatePartition (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.]

Cria uma partição em um disco básico.

O método IVdsCreatePartitionEx::CreatePartitionEx substitui esse método.

Sintaxe

HRESULT CreatePartition(
  [in]  ULONGLONG                   ullOffset,
  [in]  ULONGLONG                   ullSize,
  [in]  CREATE_PARTITION_PARAMETERS *para,
  [out] IVdsAsync                   **ppAsync
);

Parâmetros

[in] ullOffset

O deslocamento de partição.

[in] ullSize

O tamanho, em bytes, da nova partição.

[in] para

O ponteiro para parâmetros definidos pela estrutura CREATE_PARTITION_PARAMETERS .

[out] ppAsync

O endereço de um ponteiro de interface IVdsAsync , que o VDS inicializa no retorno. Os chamadores devem liberar a interface. Use esse ponteiro para cancelar, aguardar ou consultar o status da operação.

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.

Retornar código/valor	Descrição
S_OK	A partição foi criada com êxito.
VDS_E_NO_MEDIA 0x80042412L	Não há mídia em uma unidade removível.
VDS_E_INVALID_OPERATION 0x80042415L	A mídia não dá suporte a essa operação. Por exemplo, o chamador não pode criar uma partição em um CD-ROM.
VDS_E_NOT_SUPPORTED 0x80042400L	Não há suporte para a criação de uma segunda partição em mídia removível. Como alternativa, esse erro indica que o disco é um disco dinâmico.
VDS_E_PARTITION_LIMIT_REACHED 0x80042407L	O número máximo de partições (quatro primárias ou três primárias e uma estendida) já existe quando o chamador tenta criar uma partição primária adicional ou partição estendida.
VDS_S_UPDATE_BOOTFILE_FAILED 0x00042434L	A partição foi criada 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


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

CREATE_PARTITION_PARAMETERS

Objeto Disk

IVdsAdvancedDisk

IVdsAsync

IVdsCreatePartitionEx::CreatePartitionEx

Compartilhar via