Método IVdsVolumeMF3::FormatEx2 (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.]

Formata um volume do sistema de arquivos em uma partição. Esse método é idêntico ao método IVdsVolumeMF2::FormatEx , exceto que as opções de formatação são especificadas usando o parâmetro Options .

Sintaxe

HRESULT FormatEx2(
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  DWORD     Options,
  [out] IVdsAsync **ppAsync
);

Parâmetros

[in] pwszFileSystemTypeName

Uma cadeia de caracteres Unicode terminada em nulo que contém o nome do sistema de arquivos com o qual formatar o volume. Esse parâmetro pode ser NULL ou o nome de um sistema de arquivos do Windows. Há suporte para os seguintes sistemas de arquivos: "NTFS", "FAT", "FAT32", "UDF" e "EXFAT". Se esse parâmetro for NULL, o sistema de arquivos padrão será usado. Para obter mais informações, consulte VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG.

[in] usFileSystemRevision

A revisão do sistema de arquivos, se houver. Esse membro é expresso como um número decimal codificado em binário de 16 bits, em que um ponto decimal está implícito entre o segundo e o terceiro dígitos. Por exemplo, um valor de 0x0250 indica a revisão 2,50.

[in] ulDesiredUnitAllocationSize

O tamanho da unidade de alocação para o sistema de arquivos, em bytes. O valor deve ser uma potência de 2. Se o valor for 0, uma unidade de alocação padrão determinada pelo tipo de sistema de arquivos será usada. O intervalo de unidades de alocação depende do sistema de arquivos.

[in] pwszLabel

Uma cadeia de caracteres Unicode terminada em nulo a ser atribuída ao novo sistema de arquivos. O tamanho máximo do rótulo depende do sistema de arquivos.

[in] Options

Uma máscara de bits de VDS_FORMAT_OPTION_FLAGS valores de enumeração que especificam opções de formatação.

[out] ppAsync

Um ponteiro para uma interface IVdsAsync que, após a conclusão bem-sucedida, recebe a interface IVdsAsync para monitorar e controlar essa operação. Os chamadores devem liberar a interface recebida quando terminarem de usá-la.

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.

Código/valor de retorno	Descrição
S_OK 0x00000000L	O sistema de arquivos foi formatado com êxito.
VDS_E_OPERATION_DENIED 0x8004240AL	A operação será negada se o chamador tentar formatar o sistema, a inicialização, o carimbo de falha, a hibernação ou o volume de pagefile.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	O volume falhou.
VDS_E_PACK_OFFLINE 0x80042444L	O pacote que contém o volume não está acessível. Todos os volumes em um pacote offline são inacessíveis.
VDS_E_FS_NOT_DETERMINED 0x80042593L	Não foi possível determinar o sistema de arquivos padrão.

Além disso, a interface IVdsAsync pode retornar os seguintes avisos relacionados e códigos de erro.

Código/valor de retorno	Descrição
VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L	O sistema de arquivos é incompatível.
VDS_E_INCOMPATIBLE_MEDIA 0x80042426L	A mídia é incompatível.
VDS_E_ACCESS_DENIED 0x80042427L	Acesso negado.
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	A mídia é protegida por gravação.
VDS_E_BAD_LABEL 0x80042429L	O rótulo não é válido.
VDS_E_CANT_QUICK_FORMAT 0x8004242AL	O volume não pode ser formatado rapidamente.
VDS_E_IO_ERROR 0x8004242BL	Ocorreu um erro de E/S durante o formato.
VDS_E_VOLUME_TOO_SMALL 0x8004242CL	O tamanho do volume é muito pequeno para ser formatado.
VDS_E_VOLUME_TOO_BIG 0x8004242DL	O tamanho do volume é muito grande para ser formatado.
VDS_E_CLUSTER_SIZE_TOO_SMALL 0x8004242EL	O tamanho do cluster é muito pequeno para permitir a formatação.
VDS_E_CLUSTER_SIZE_TOO_BIG 0x8004242FL	O tamanho do cluster é muito grande para permitir a formatação.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS 0x80042430L	O número de clusters é muito grande para ser representado como um inteiro de 32 bits.
VDS_S_VOLUME_COMPRESS_FAILED 0x00042443L	O sistema de arquivos é formatado, mas não compactado.
VDS_E_CANT_INVALIDATE_FVE 0x80042592L	Não foi possível desabilitar a criptografia do BitLocker para o volume.

Requisitos


Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vds.h
Biblioteca	Uuid.lib

Confira também

IVdsVolumeMF2::FormatEx

IVdsVolumeMF3

VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG

VDS_FORMAT_OPTION_FLAGS

Compartilhar via