Created the new NativeStorable

Author: 0x5bfa

src/Files.App.Storage/Storables/Native/INativeStorable.cs

@@ -0,0 +1,18 @@
+// Copyright (c) 2024 Files Community
+// Licensed under the MIT License. See the LICENSE.
+
+namespace Files.App.Storage.Storables
+{
+	/// <summary>
+	/// Represents a file object that is natively supported by Windows Shell API.
+	/// </summary>
+	public class INativeStorable : NativeStorable
+	{
+		/// <summary>
+		/// Get a property value from this <see cref="INativeStorable"/>.
+		/// </summary>
+		/// <param name="id">The property ID (e.g. "System.Image.Dimensions").</param>
+		/// <returns>Returns a valid value formatted with string; otherwise, returns <see cref="string.Empty"/>.</returns>
+        public string GetPropertyAsync(string id);
+	}
+}

src/Files.App.Storage/Storables/Native/NativeFile.cs

@@ -1,14 +1,12 @@
 // Copyright (c) 2024 Files Community
 // Licensed under the MIT License. See the LICENSE.
 
-using System.IO;
-
 namespace Files.App.Storage.Storables
 {
 	/// <summary>
 	/// Represents a file object that is natively supported by Windows Shell API.
 	/// </summary>
-	public class NativeFile : NativeStorable
+	public class NativeFile : NativeStorable/*, IFile*/
 	{
 	}
 }

src/Files.App.Storage/Storables/Native/NativeFolder.cs

@@ -1,15 +1,38 @@
 // Copyright (c) 2024 Files Community
 // Licensed under the MIT License. See the LICENSE.
 
-using System.IO;
-using System.Runtime.CompilerServices;
-
 namespace Files.App.Storage.Storables
 {
 	/// <summary>
 	/// Represents a folder object that is natively supported by Windows Shell API.
 	/// </summary>
-	public class NativeFolder : NativeStorable
+	public class NativeFolder : NativeStorable/*, IFolder*/
     {
+		public async IAsyncEnumerable<IStorable> GetChildrenAsync()
+		{
+			foreach (var storable in GetChildren())
+			{
+				await Task.Yield();
+
+				yield return storable;
+			}
+
+			unsafe IEnumerable<NativeStorable> GetChildren()
+			{
+				using ComPtr<IEnumShellItems> pEnumShellItems = default;
+				fixed (Guid* pBHID = PInvoke.BHID_EnumItems)
+				{
+					hr = pRecycleBinFolderShellItem.Get()->BindToHandler(
+						null,
+						pBHID,
+						(Guid*)Unsafe.AsPointer(ref Unsafe.AsRef(in IEnumShellItems.Guid)),
+						(void**)pEnumShellItems.GetAddressOf());
+
+						ComPtr<IShellItem> pShellItem = default;
+						while (pEnumShellItems.Get()->Next(1, pShellItem.GetAddressOf()) == HRESULT.S_OK)
+							yield return NativeStorable(pShellItem);
+				}
+			}
+		}
 	}
 }

src/Files.App.Storage/Storables/Native/NativeStorable.cs

@@ -1,14 +1,107 @@
 // Copyright (c) 2024 Files Community
 // Licensed under the MIT License. See the LICENSE.
 
-using System.IO;
+using System.Runtime.InteropServices;
+using Windows.Win32;
+using Windows.Win32.Foundation;
+using Windows.Win32.System.Com;
+using Windows.Win32.UI.Shell;
 
 namespace Files.App.Storage.Storables
 {
 	/// <summary>
 	/// Represents a storable that is natively supported by Windows Shell API.
 	/// </summary>
-	public abstract class NativeStorable
+	public abstract class NativeStorable, INativeStorable
 	{
+		/// <inheritdoc/>
+		/// <remarks>
+		/// This must be a path that can be parsed by SHCreateItemFromParsingName.
+		/// </remarks>
+		public string Path { get; protected set; }
+
+		/// <inheritdoc/>
+		/// <remarks>
+		/// This must be a path that can be parsed by SHParseDisplayName.
+		/// </remarks>
+		public string Name { get; protected set; }
+
+		/// <inheritdoc/>
+		public string Id { get; protected set; } // Won't use
+
+		protected ComPtr<IShellItem> m_pShellItem { get; private set; }
+
+		/// <summary>
+		/// Initializes an instance of <see cref="NativeStorable"/> class.
+		/// </summary>
+		/// <param name="path">Win32 file namespace, shell namespace, or UNC path.</param>
+		public unsafe NativeFile(string path)
+		{
+			HRESULT hr = PInvoke.SHCreateItemFromParsingName(
+				path,
+				null,
+				(Guid*)Unsafe.AsPointer(ref Unsafe.AsRef(in IShellItem.Guid)),
+				(void**)m_pShellItem.GetAddressOf());
+		}
+
+		/// <summary>
+		/// Initializes an instance of <see cref="NativeStorable"/> class.
+		/// </summary>
+		/// <param name="shellGuid">An instance of GUID that represents a shell folder.</param>
+		public unsafe NativeStorable(Guid shellGuid)
+		{
+			HRESULT hr = default;
+
+			// For known folders
+			fixed (Guid* pFolderId = shellGuid)
+			{
+				hr = PInvoke.SHGetKnownFolderItem(
+					pFolderId,
+					KNOWN_FOLDER_FLAG.KF_FLAG_DEFAULT,
+					HANDLE.Null,
+					(Guid*)Unsafe.AsPointer(ref Unsafe.AsRef(in IShellItem.Guid)),
+					(void**)m_pShellItem.GetAddressOf());
+			}
+
+			if (hr == HRESULT.S_OK)
+				return;
+
+			string path = $"Shell:::{shellGuid.ToString("B")}";
+
+			hr = PInvoke.SHCreateItemFromParsingName(
+				path,
+				null,
+				(Guid*)Unsafe.AsPointer(ref Unsafe.AsRef(in IShellItem.Guid)),
+				(void**)m_pShellItem.GetAddressOf());
+		}
+
+		/// <summary>
+		/// Initializes an instance of <see cref="NativeStorable"/> class.
+		/// </summary>
+		/// <param name="pShellItem">An instance of <see cref="IShellItem"/>.</param>
+		public NativeStorable(ComPtr<IShellItem> pShellItem)
+		{
+			m_pShellItem = pShellItem;
+		}
+
+		/// <inheritdoc/>
+		public string GetPropertyAsync(string id)
+		{
+			using ComPtr<IShellItem2> pShellItem2 = default;
+			hr = pShellItem.Get()->QueryInterface(
+				(Guid*)Unsafe.AsPointer(ref Unsafe.AsRef(in IShellItem2.Guid)),
+				(void**)pShellItem2.GetAddressOf());
+
+			hr = PInvoke.PSGetPropertyKeyFromName(
+				id,
+				out var propertyKey);
+
+			using ComHeapPtr<LPWSTR> pPropertyValue;
+			hr = pShellItem2.Get()->GetString(
+				propertyKey,
+				(void**)pPropertyValue.GetAddressOf());
+
+			return szPropertyValue.Get()->ToString();
+		}
 	}
 }