docs: document GetHandleInfo(), GetHandleInformation(SafeHandle)

Author: BinToss

deadlock-dotnet-sdk/Windows.Win32/PInvoke.cs

@@ -208,5 +208,9 @@ public static bool PrivilegeCheck(SafeHandle ClientToken, ref PRIVILEGE_SET Requ
     public static SafeFileHandle OpenProcessToken(SafeFileHandle ProcessHandle, TOKEN_ACCESS_MASK DesiredAccess)
         => OpenProcessToken(ProcessHandle, DesiredAccess, out SafeFileHandle TokenHandle) ? TokenHandle : throw new Win32Exception();
 
+    /// <summary>Get the handle's flags/attributes.</summary>
+    /// <param name="hObject"><inheritdoc cref="GetHandleInformation(HANDLE, uint*)" path="/param[@name='hObject']"/></param>
+    /// <returns>A copy of the handle's current flags/attributes as <see cref="HANDLE_FLAGS"/></returns>
+    /// <exception cref="Win32Exception">The P/Invoke operation failed.</exception>
     public static HANDLE_FLAGS GetHandleInformation(SafeHandle hObject) => GetHandleInformation(hObject, out uint flags) ? (HANDLE_FLAGS)flags : throw new Win32Exception();
 }

deadlock-dotnet-sdk/Windows.Win32/SYSTEM_HANDLE_TABLE_ENTRY_INFO_EX.cs

@@ -80,6 +80,11 @@ public unsafe string GetHandleObjectType()
             : throw new NTStatusException(status);
     }
 
+    /// <summary>
+    /// Get the current HANDLE_FLAGS of this handle if it is still open.
+    /// </summary>
+    /// <returns></returns>
+    /// <exception cref="Win32Exception">Failed to get handle information -OR- failed to open process to duplicate handle.</exception>
     public unsafe HANDLE_FLAGS GetHandleInfo()
     {
         try