Export (0) Print
Expand All
Expand Minimize

2.3.50 FSCTL_GET_INTEGRITY_INFORMATION_Reply

The FSCTL_GET_INTEGRITY_INFORMATION Reply message returns the results of the FSCTL_GET_INTEGRITY_INFORMATION Request (section 2.3.49) and indicates the current integrity state of the file or directory.

The FSCTL_GET_INTEGRITY_INFORMATION_BUFFER data element is as follows.


0

1

2

3

4

5

6

7

8

9
1
0

1

2

3

4

5

6

7

8

9
2
0

1

2

3

4

5

6

7

8

9
3
0

1

ChecksumAlgorithm

Reserved

Flags

ChecksumChunkSizeInBytes

ClusterSizeInBytes

ChecksumAlgorithm (2 bytes): MUST be one of the following standard values.

Value Meaning

CHECKSUM_TYPE_NONE
0x0000

The file or directory is not configured to use integrity.

CHECKSUM_TYPE_CRC64
0x0002

The file or directory is configured to use a CRC64 checksum to provide integrity.

All other values

Reserved for future use and MUST NOT be used.

Reserved (2 bytes): A 16-bit reserved value. This field MUST be set to 0x0000 and MUST be ignored.

Flags (4 bytes): A 32-bit unsigned integer that contains zero or more of the following flag values. Flag values not specified in the following table SHOULD be set to 0 and MUST be ignored.

Value Meaning

FSCTL_INTEGRITY_FLAG_CHECKSUM_ENFORCEMENT_OFF
0x00000001

Indicates that checksum enforcement is not currently enabled on the target file.

All other values

Reserved for future use and MUST NOT be used.

ChecksumChunkSizeInBytes (4 bytes): A 32-bit unsigned integer specifying the size in bytes of each chunk in a stream that is configured with integrity.

ClusterSizeInBytes (4 bytes): A 32-bit unsigned integer specifying the size of a cluster for this volume in bytes.

This message also returns a status code, as specified in [MS-ERREF] section 2.3. The status code returned directly by the function that processes this FSCTL MUST be STATUS_SUCCESS or one of the following.

Error code

Meaning

STATUS_INVALID_PARAMETER

0xC000000D

The output buffer length is less than the size of the FSCTL_GET_INTEGRITY_INFORMATION_BUFFER data element, or the handle is not to a file or directory.

STATUS_INVALID_DEVICE_REQUEST

0xC0000010

The volume does not support integrity.

 
Show:
© 2014 Microsoft