Método ExcludeFromAutochk da classe Win32_LogicalDisk

O método ExcludeFromAutochk exclui discos da operação de autochk a serem executados na próxima reinicialização.

Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.

Sintaxe

uint32 ExcludeFromAutochk(
  [in] string LogicalDisk[]
);

Parâmetros

LogicalDisk [in]

Lista de unidades que devem ser excluídas do autochk na próxima reinicialização. A sintaxe da cadeia de caracteres consiste na letra da unidade seguida por dois-pontos para o disco lógico.

Exemplo: "C:"

Valor retornado

Retorna um valor de 0 (zero) quando nenhum erro ocorre. Os valores são listados na lista a seguir. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Êxito (0)

Erro – Unidade Remota (1)

Erro – Unidade Removível (2)

Erro – Diretório Não Raiz da Unidade (3)

Erro – Unidade Desconhecida (4)

Comentários

Se não for excluído, o autochk será executado no disco quando o sujo bit estiver definido para o disco. Observe que as chamadas para excluir discos não são cumulativas. Se uma chamada for feita para excluir alguns discos, a nova lista não será adicionada à lista de discos que já estão marcados para exclusão. A nova lista de discos substitui a lista anterior. Esse método só é aplicável às instâncias de disco lógico que representam um disco físico no computador. Não é aplicável a unidades lógicas mapeadas.

Exemplos

O exemplo de código VBScript a seguir garante que Autochk.exe não serão executados na unidade C na próxima vez que o computador for reinicializado, mesmo que o "sujo bit" tenha sido definido na unidade C.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set objDisk = objWMIService.Get("Win32_LogicalDisk") 
 
errReturn = objDisk.ExcludeFromAutoChk(Array("C:")) 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

Win32_LogicalDisk

Classes de hardware do sistema de computador