Compartilhar via


Método redimensionar da classe MSFT_Partition

Redimensiona a partição e qualquer volume do sistema de arquivos associado ao tamanho especificado pelo parâmetro Size .

Sintaxe

UInt32 Resize(
  [in]  UInt64 Size,
  [out] String ExtendedStatus
);

Parâmetros

Tamanho [in]

O novo tamanho do disco. Esse parâmetro é necessário e não pode ser zero.

ExtendedStatus [out]

Uma cadeia de caracteres que contém um objeto MSFT_StorageExtendedStatus inserido.

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

Retornar valor

Sucesso (0)

Sem suporte (1)

Erro não especificado (2)

Tempo limite (3)

Falha (4)

Parâmetro inválido (5)

Tamanho sem suporte (4097)

Acesso negado (40001)

Não há recursos suficientes para concluir a operação. (40002)

Não é possível reduzir uma partição que contém um volume com erros. (42008)

Não é possível redimensionar uma partição que contenha um sistema de arquivos desconhecido. (42009)

Comentários

Esse método redimensiona a partição e qualquer sistema de arquivos associado ao tamanho especificado pelo parâmetro Size . Se o tamanho estiver fora dos limites retornados pelo método GetSupportedSize , esse método falhará com um código de erro bem definido. A operação de redimensionamento tem suporte apenas em partições formatadas em NTFS e partições RAW.

Se o tamanho especificado for menor que o tamanho original, esse método moverá arquivos para que eles estejam o mais próximo possível do início da partição, para consolidar o espaço livre no final da partição. Em seguida, ele trunca o volume do sistema de arquivos, reduzindo seu tamanho e, em seguida, trunca a partição.

Em quase todos os casos, haverá alguns arquivos que são imóveis (ou seja, não podem ser movidos). Por exemplo, os arquivos de metadados do sistema de arquivos e do driver de armazenamento provavelmente serão imóveis. Por esse motivo, a quantidade pela qual uma partição pode ser reduzida geralmente é menor do que a quantidade total de espaço livre na partição.

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_Partition