Compartilhar via


Método de formato da classe MSFT_Volume

Formata o volume.

Sintaxe

UInt32 Format(
  [in]  String  FileSystem,
  [in]  String  FileSystemLabel,
  [in]  UInt32  AllocationUnitSize,
  [in]  Boolean Full,
  [in]  Boolean Force,
  [in]  Boolean Compress,
  [in]  Boolean ShortFileNameSupport,
  [in]  Boolean SetIntegrityStreams,
  [in]  Boolean UseLargeFRS,
  [in]  Boolean DisableHeatGathering,
  [out] String  FormattedVolume,
  [out] String  ExtendedStatus
);

Parâmetros

FileSystem [in]

O sistema de arquivos a ser aplicado ao volume. Um dos seguintes:

  • "ExFAT"
  • "FAT"
  • "FAT32"
  • "NTFS"
  • "ReFS"

FileSystemLabel [in]

O rótulo do sistema de arquivos do volume.

AllocationUnitSize [in]

O tamanho da unidade de alocação, em bytes.

Full [in]

TRUE para um formato completo ou FALSE para um formato rápido.

Force [in]

TRUE para forçar a operação de formato; caso contrário, FALSE.

Compress [in]

TRUE para compactar o volume; caso contrário, FALSE. Deixe indefinido se FileSystem estiver definido como ReFS.

ShortFileNameSupport [in]

TRUE se o volume deve oferecer suporte a nomes curtos; caso contrário, FALSE. Deixe indefinido se FileSystem estiver definido como ReFS.

SetIntegrityStreams [in]

TRUE para definir fluxos de integridade. Deixe indefinido, a menos que FileSystem esteja definido como ReFS.

UseLargeFRS [in]

TRUE para usar FRS grande; caso contrário, FALSE. Deixe indefinido se FileSystem estiver definido como ReFS.

DisableHeatGathering [in]

TRUE para desativar a coleta de calor; caso contrário, FALSE.

FormattedVolume [out]

Recebe um objeto MSFT_Volume que representa o volume formatado.

ExtendedStatus [out]

Contém um objeto MSFT_StorageExtendedStatus incorporado.

Esse parâmetro permite que o provedor de armazenamento retorne informações de erro estendidas (específicas da implementação).

Valor retornado

Êxito (0)

Sem suporte (1)

Erro não especificado (2)

Tempo limite (3)

Com falha (4)

Parâmetro inválido (5)

Este comando não é compatível com x86 em execução no ambiente x64. (7)

Acesso negado (40001)

Ocorreu um erro de E/S inesperado (40004)

O objeto especificado é gerenciado pelo componente de clustering de failover da Microsoft. O disco deve estar no modo de manutenção de cluster, e o status do recurso de cluster deve estar online para executar essa operação. (40018)

A operação não é permitida em um sistema ou partição crítica. (42010)

O tamanho do cluster especificado é inválido (43000)

O sistema de arquivos especificado é incompatível (43001)

O volume não pode ser formatado rapidamente (43002)

O número de clusters excede 32 bits (43003)

Não há suporte para a versão UDF especificada (43004)

O tamanho do cluster deve ser um múltiplo do tamanho do setor físico do disco (43005)

Não é possível executar a operação solicitada quando a unidade é somente leitura (43006)

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

Confira também

MSFT_Volume