Método IVdsAdvancedDisk::FormatPartition (vds.h)
[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 |
|---|---|
|
A partição foi formatada com êxito. |
|
O disco é removível ou a partição não é do tipo OEM, ESP ou desconhecido. |
|
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 |