Método Clear da classe MSFT_Disk
Remove informações de partição e não inicializa um disco, retornando-o para um estado RAW.
Sintaxe
UInt32 Clear(
[in] Boolean RemoveData,
[in] Boolean RemoveOEM,
[in] Boolean ZeroOutEntireDisk,
[out] String ExtendedStatus
);
Parâmetros
RemoveData [in]
TRUE se não for possível remover partições de dados do disco. Se esse parâmetro for FALSE ou NULL, esse método falhará na presença de uma partição de dados.
RemoveOEM [in]
TRUE se não for possível remover o OEM e outras partições especiais. Se esse parâmetro for FALSE ou não for especificado, esse método falhará na presença desses tipos de partições.
ZeroOutEntireDisk [in]
TRUE se esse parâmetro instruir esse método a zerado todo o disco, além de remover todas as informações de partição. Se esse parâmetro for FALSE ou NULL, somente o primeiro e o último megabytes do disco serão zerados.
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
Êxito (0)
Sem suporte (1)
Erro não especificado (2)
Tempo limite (3)
Falha (4)
Parâmetro inválido (5)
O disco está em uso (6)
Acesso negado (40001)
Não há recursos suficientes para concluir a operação. (40002)
Cache desatualizado (40003)
O disco não foi inicializado. (41000)
O disco é somente leitura. (41002)
O disco está offline. (41003)
Não é possível limpar com partições OEM presentes. Para limpar partições OEM, use o sinalizador RemoveOEM. (41007)
Não é possível limpar com partições de dados presentes. Para limpar partições de dados, use o sinalizador RemoveData. (41008)
Operação sem suporte em um disco crítico. (41009)
Não há mídia no dispositivo. (41015)
O objeto especificado é gerenciado pelo componente Clustering de Failover da Microsoft. O disco deve ser removido do cluster para executar essa operação. (41019)
Comentários
O chamador deve especificar RemoveData, RemoveOEM ou ambos, a menos que primeiro exclua todas as partições de dados, partições OEM conhecidas e partições ESP no disco. Esse requisito exclui partições de metadados, como o MSR, a partição de metadados LDM e partições OEM desconhecidas.
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 |