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.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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. |