DiskRunChkDsk
Determines whether the operating system runs chkdsk on a physical disk before attempting to mount the disk. The following table summarizes the attributes of the DiskRunChkDsk property.
| Attribute | Value |
|---|---|
|
Data type |
DWORD |
|
Access | |
|
Status |
Optional |
|
Structure | |
|
Minimum |
0 |
|
Maximum |
6 |
|
Default |
0 |
Remarks
Setting DiskRunChkDsk to FALSE causes the operating system to mount the disk without running chkdsk. With DiskRunChkDsk set to TRUE (the default), the operating system runs chkdsk first and, if errors are found, takes action based on the ConditionalMount property. The following table summarizes the interaction between DiskRunChkDsk and ConditionalMount.
| Value | Description |
|---|---|
|
0 (Default) |
Performs a quick check to verify volume is okay during online, runs chkdsk to recover from any corruption. Fails online if chkdsk is unable to repair. |
|
1 |
Performs a thorough check to verify volume is okay during online, runs chkdsk to recover from any corruption. Fails online if chkdsk is unable to repair. |
|
2 |
Always run chkdsk on volumes during online. Fail online if chkdsk fails due to any reason. |
|
3 |
Same behavior as option #0, except if the quick volume check returns okay, run chkdsk in readonly mode (i.e. chkdsk on a snapshot of the volume) and proceed with online. |
|
4 |
Don't perform any file system level checks during online. In this mode IsAlive or LooksAlive calls don't do any file system level verification. |
|
5 |
Perform a thorough check to verify volume during online. Fail online if the volume/FS checks fail due to any reason. Do not attempt recovery using chkdsk. |
|
6 |
Suppresses volume creation/online/mounting during disk resource online. Disk is in offline read write mode, i.e. the disk is readable/writable using raw block level IOs. |
Forcing a disk to mount despite errors can result in loss of data. Use caution when changing these properties.
Note The chkdsk tool cannot be run on a cluster shared volume (CSV) that is operating in redirected mode.
Examples
The property value portion of a property list entry for DiskRunChkDsk can be set with the following example code.
DWORD DiskRunChkdskData = 5;
CLUSPROP_DWORD DiskRunChkdskValue;
DiskRunChkdskValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
DiskRunChkdskValue.cbLength = sizeof(DWORD);
DiskRunChkdskValue.dw = DiskRunChkdskData;
Requirements
|
Minimum supported client | None supported [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [desktop apps only] |
See also
Send comments about this topic to Microsoft
Build date: 11/28/2012
