ExcludeFromAutochk method of the Win32_LogicalDisk class

The ExcludeFromAutochk method excludes disks from the autochk operation to be run at the next reboot.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax


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

Parameters

LogicalDisk [in]

List of drives that should be excluded from autochk at the next reboot. The string syntax consists of the drive letter followed by a colon for the logical disk.

Example: "C:"

Return value

Returns a value of 0 (zero) when no error occurs. Values are listed in the following list. For additional error codes, see WMI Error Constants or WbemErrorEnum. For general HRESULT values, see System Error Codes.

Success (0)
Error - Remote Drive (1)
Error - Removable Drive (2)
Error - Drive Not Root Directory (3)
Error - Unknown Drive (4)

Remarks

If not excluded, autochk is performed on the disk when the dirty bit is set for the disk. Note that the calls to exclude disks are not cumulative. If a call is made to exclude some disks, then the new list is not added to the list of disks that are already marked for exclusion. The new list of disks overwrites the previous list. This method is only applicable to those instances of logical disk that represent a physical disk in the machine. It is not applicable to mapped logical drives.

Examples

The following VBScript code sample ensures that Autochk.exe will not run against drive C the next time the computer reboots, even if the "dirty bit" has been set on drive C.


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

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Win32_LogicalDisk
Computer System Hardware Classes

 

 

Show: