Changeset 107382 in vbox

Timestamp:

Dec 19, 2024 1:55:07 PM (4 weeks ago)

Author:

vboxsync

Message:

IPRT/r3/nt: Some FILE_INFORMATION_CLASS doc updates for NT4 and earlier. bugref:10826

Location:

trunk

Files:

• include/iprt/nt/nt.h (modified) (1 diff)
• src/VBox/Runtime/r3/nt/RTFileDelete-r3-nt.cpp (modified) (2 diffs)
• src/VBox/Runtime/r3/nt/RTPathQueryInfo-nt.cpp (modified) (1 diff)
• src/VBox/Runtime/r3/nt/direnum-r3-nt.cpp (modified) (1 diff)

trunk/include/iprt/nt/nt.h

@@ -2480 +2480 @@
     FileMailslotSetInformation,
     FileCompressionInformation,
-    FileObjectIdInformation,
+    /* NT351 and NT4 have different stuff assigned from here on. */
+    FileObjectIdInformation,        /**< NT4 and earlier has FileCopyOnWriteInformation here - only for setting, not querying. */
     FileCompletionInformation,
     FileMoveClusterInformation,
-    FileQuotaInformation,
-    FileReparsePointInformation,
+    FileQuotaInformation,           /**< NT35 has FileStorageInformation here (query+set) and NT4 FileOleClassIdInformation (set only). Last for NT35. */
+    FileReparsePointInformation,    /**< NT4 has FileOleStateBitsInformation here (set only). */
     FileNetworkOpenInformation,
-    FileAttributeTagInformation,
-    FileTrackingInformation,
-    FileIdBothDirectoryInformation,
-    FileIdFullDirectoryInformation,
-    FileValidDataLengthInformation,
-    FileShortNameInformation,
+    FileAttributeTagInformation,    /**< NT4 has FileObjectIdInformation here (set only). */
+    FileTrackingInformation,        /**< NT4 has FileOleAllInformation here (query only). Last for W2K. */
+    FileIdBothDirectoryInformation, /**< NT4 has FileOleDirectoryInformation here (dir query only). */
+    FileIdFullDirectoryInformation, /**< NT4 has FileContentIndexInformation here (set only). */
+    FileValidDataLengthInformation, /**< NT4 has FileInheritContentIndexInformation here (set only). */
+    FileShortNameInformation,       /**< NT4 has FileOleInformation here (query + set). Last for NT4. */
     FileIoCompletionNotificationInformation,
     FileIoStatusBlockRangeInformation,

trunk/src/VBox/Runtime/r3/nt/RTFileDelete-r3-nt.cpp

@@ -111 +111 @@
              *
              * See @bugref{10632}.
+             *
+             * Note! On NT4 the value later used for FileAttributeTagInformation was
+             *       called FileObjectIdInformation, but fortunately that could only
+             *       be set and will fail with STATUS_INVALID_INFO_CLASS when queried.
              */
             FILE_ATTRIBUTE_TAG_INFORMATION TagInfo = {0, 0};
@@ -134 +138 @@
                 }
             }
-            else if (   rcNt == STATUS_INVALID_PARAMETER || rcNt == STATUS_NOT_IMPLEMENTED
-                     /** Needed for NT4. See @bugref{10826}. */
-                     || rcNt == STATUS_INVALID_INFO_CLASS)
+            else if (   rcNt == STATUS_INVALID_PARAMETER
+                     || rcNt == STATUS_NOT_IMPLEMENTED
+                     || rcNt == STATUS_INVALID_INFO_CLASS /* NT4 and earlier */)
                 rcNt = STATUS_SUCCESS;
             else

trunk/src/VBox/Runtime/r3/nt/RTPathQueryInfo-nt.cpp

@@ -483 +483 @@
         if (NT_SUCCESS(rcNt))
         {
-            /* Query tag information first in order to try re-open non-symlink reparse points. */
+            /* Query tag information first in order to try re-open non-symlink reparse points.
+               Note! On NT4 the value later used for FileAttributeTagInformation was
+                     called FileObjectIdInformation, but fortunately that could only
+                     be set and will fail with STATUS_INVALID_INFO_CLASS when queried. */
             FILE_ATTRIBUTE_TAG_INFORMATION TagInfo;
             rcNt = NtQueryInformationFile(hFile, &Ios, &TagInfo, sizeof(TagInfo), FileAttributeTagInformation);

trunk/src/VBox/Runtime/r3/nt/direnum-r3-nt.cpp

@@ -182 +182 @@
 
                 /*
-                 * We now need to check if we opened a symbolic directory link.
+                 * We now need to check if we opened a symbolic directory link (W2K+;
+                 * on NT4 this is FileObjectIdInformation but it can't be queried and
+                 * should thus fail with STATUS_INVALID_INFO_CLASS).
                  * (These can be enumerated, but contains only '.' and '..'.)
                  */