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 |
|
| DLL |
|