2.4.11 FileDispositionInformation

This information class is used to mark a file for deletion.

A FILE_DISPOSITION_INFORMATION data element, defined as follows, is provided by the client.


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

DeletePending

DeletePending (1 byte):  An 8-bit field that is set to 1 to indicate that a file SHOULD be deleted when it is closed; otherwise, 0.<112>

For a discussion of file deletion semantics, see [FSBO].

This operation returns a status code as specified in section 2.2. Upon success, the status code returned by the function that processes this file information class is STATUS_SUCCESS. The most common error codes are listed in the following table.

Error code

Meaning

STATUS_ACCESS_DENIED

0xC0000022

The handle was not opened with delete access.

STATUS_INFO_LENGTH_MISMATCH

0xC0000004

The specified information record length does not match the length that is required for the specified information class.

STATUS_DIRECTORY_NOT_EMPTY

0xC0000101

Indicates that the directory trying to be deleted is not empty.