2.5.6 FileFsObjectIdInformation
This information class is used to query or set the object ID for a file system data element. The operation MUST fail if the file system does not support object IDs.<162>
A FILE_FS_OBJECTID_INFORMATION data element, defined as follows, is returned by the server or provided by the client.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ObjectId (16 bytes) |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
ExtendedInfo (48 bytes) |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
... |
ObjectId (16 bytes): A 16-byte GUID that identifies the file system volume on the disk. This value is not required to be unique on the system.
ExtendedInfo (48 bytes): A 48-byte value containing extended information on the file system volume. If no extended information has been written for this file system volume, the server MUST return 48 bytes of 0x00 in this field.<163>
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 system information class is STATUS_SUCCESS. The most common error codes are listed in the following table.
Error code |
Meaning |
---|---|
STATUS_INFO_LENGTH_MISMATCH 0xC0000004 |
The specified information record length does not match the length that is required for the specified information class. |
STATUS_VOLUME_NOT_UPGRADED 0xC000029C |
The file system on the volume does not support object IDs. |
STATUS_INVALID_PARAMETER 0xC000000D |
The file system does not implement object IDs. |