Chkdsk method of the Win32_LogicalDisk class

The Chkdsk instance method invokes the chkdsk operation on the disk.

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

Syntax

uint32 Chkdsk(
  [in] boolean FixErrors = ,
  [in] boolean VigorousIndexCheck = ,
  [in] boolean SkipFolderCycle = ,
  [in] boolean ForceDismount = ,
  [in] boolean RecoverBadSectors = ,
  [in] boolean OKToRunAtBootUp = 
);

Parameters

FixErrors [in]

Indicates what should be done to errors found on the disk. If true, then errors are fixed. The default is false.

VigorousIndexCheck [in]

If true, a less vigorous check of index entries should be performed. The default is false.

SkipFolderCycle [in]

If true, the folder cycle checking should be skipped. The default is true.

ForceDismount [in]

If true, the drive should be forced to dismount before checking. The default is false.

RecoverBadSectors [in]

If true, the bad sectors should be located and the readable information should be recovered from these sectors. The default is false.

OKToRunAtBootUp [in]

If true, the chkdsk operation should be performed at next boot up time, in case the operation could not be performed because the disk is locked at time this method is called. The default is false.

Return value

Returns a value of 0 (zero) if successful. Other 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 - Chkdsk completed

0

Success - Chkdsk Completed

Success - Locked and chkdsk scheduled on reboot

1

Failure - Unknown file system

2

Failure - Unknown error

3

Failure - Unsupported File System

4

Remarks

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 Runs ChkDsk.exe against drive D on a computer.

Const FIX_ERRORS = True 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set objDisk = objWMIService.Get("Win32_LogicalDisk.DeviceID='D:'") 
 
errReturn = objDisk.ChkDsk(FIX_ERRORS) 

Requirements

Requirement Value
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