Método IVdsAdvancedDisk::FormatPartition (vds.h)

Artigo
03/03/2024

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

Formata uma partição OEM, ESP ou desconhecida existente.

Sintaxe

HRESULT FormatPartition(
  [in]  ULONGLONG            ullOffset,
  [in]  VDS_FILE_SYSTEM_TYPE type,
  [in]  LPWSTR               pwszLabel,
  [in]  DWORD                dwUnitAllocationSize,
  [in]  BOOL                 bForce,
  [in]  BOOL                 bQuickFormat,
  [in]  BOOL                 bEnableCompression,
  [out] IVdsAsync            **ppAsync
);

Parâmetros

[in] ullOffset

O deslocamento de partição.

[in] type

Um VDS_FILE_SYSTEM_TYPE valor de enumeração que especifica o sistema de arquivos a ser usado. Deve ser um dos seguintes: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 ou VDS_FST_UDF.

[in] pwszLabel

Uma cadeia de caracteres que representa o rótulo de volume.

[in] dwUnitAllocationSize

O tamanho da unidade de alocação para o sistema de arquivos em bytes, que geralmente está entre 512 e 65536.

[in] bForce

Se TRUE, a partição será formatada mesmo enquanto estiver em uso; caso contrário, a operação falhará.

[in] bQuickFormat

Se TRUE, o VDS executará um formato rápido. Um formato rápido não verifica cada setor no volume.

[in] bEnableCompression

Se TRUE, habilita a compactação no sistema de arquivos recém-formatado. A compactação é um recurso do NTFS e não pode ser definida para sistemas de arquivos FAT e FAT32.

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

Valor/código retornado	Descrição
S_OK	A partição foi formatada com êxito.
VDS_E_INVALID_OPERATION 0x80042415L	O disco é removível ou a partição não é do tipo OEM, ESP ou desconhecido.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	A partição não existe.

Comentários

O VDS implementa esse método.

Esse método formata apenas OEM, ESP e partições desconhecidas. Para outras partições, você deve formatar o volume correspondente usando o método IVdsVolumeMF::Format ou IVdsVolumeMF2::FormatEx . Observe que as partições OEM, ESP e desconhecidas não são expostas como volumes e, portanto, não podem ser formatadas com Format ou FormatEx.

Esse método não pode ser usado para formatar mídia removível.

Para obter informações sobre os limites do sistema de arquivos, como tamanho mínimo e máximo da unidade de alocação (também chamado de tamanho do cluster), consulte Referência Técnica do NTFS e Referência Técnica fat.

Se uma partição OEM for formatada como FAT ou FAT32, o tipo de partição não será alterado. Se for formatado com NTFS, o tipo de partição será alterado para PARTITION_IFS (0x07). Para obter informações sobre tipos de partição, consulte CREATE_PARTITION_PARAMETERS.

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