(C#)Windows Shell 外殼編程系列1 – 基礎，瀏覽一個檔案夾

（本系列文章由檸檬的(lc_mtt)原創，轉載請註明出處，謝謝～）

Windows Shell 編程，即 Windows 外殼編程。我們所看到的資源管理員以及整個案頭，都是一個 Shell。

關於 Windows 外殼的基本概念，我這裡不做詳細介紹，不瞭解的朋友，可以看看 薑偉華 的 Windows外殼名字空間的瀏覽。

好，現在讓我們從基礎學起，早日做出一個強大的資源管理員軟體。（偶也是初學者，多多指教）

1 - 基礎，瀏覽一個檔案夾

我們知道，在win32中是以外殼名字空間的形式來組織檔案系統的，在外殼名字空間裡的每一個對象(注)都實現了一個IShellFolder的介面，通過這個介面我們可以直接查詢或間接得到其他相關的介面。
（註：這裡的對象指的是外殼名字空間中的一個節點，對象有可能是一個檔案夾，有可能是一個檔案，也有可能是一個虛擬資料夾，例如：我的電腦，網路位置，控制台等）

在C#中，我們這樣定義 IShellFolder 介面：

IShellFolder.cs
using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.InteropServices;

namespace WinShell
{
    [ComImport]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    [Guid("000214E6-0000-0000-C000-000000000046")]
    public interface IShellFolder
    {
    }
}

當然，這個介面還沒有列出細節函數。我們要做的僅僅是從最基礎開始。

首先我們必須瞭解，在外殼編程中，要使用 PIDL 路徑代替普通路徑（如果對 PIDL 不熟悉，請看Windows外殼名字空間的瀏覽）。

“案頭”是最頂級的檔案夾，外殼名字空間中其他各項都可以用從“案頭”開始的 PIDL 加以表示。

如何擷取“案頭”的 PIDL 和其 IShellFolder 介面呢，可以通過 API SHGetDesktopFolder：

[DllImport("shell32.dll")]
        public static extern Int32 SHGetDesktopFolder(out IntPtr ppshf);

/**//// <summary>
        /// 獲得案頭 Shell
        /// </summary>
        public static IShellFolder GetDesktopFolder(out IntPtr ppshf)
        {
            SHGetDesktopFolder(out ppshf);
            Object obj = Marshal.GetObjectForIUnknown(ppshf);
            return (IShellFolder)obj;
        }

//獲得案頭 PIDL
            IntPtr desktopPtr;
            IShellFolder desktop = API.GetDesktopFolder(out desktopPtr);

好的，我們取得“案頭”的 IShellFolder 介面，就已經成功了一半。現在我需要通過“案頭”，來擷取“C:\”這個路徑的 PIDL 和 IShellFolder 介面，可以通過 IShellFolder 的 ParseDisplayName 和 BindToObject 函數來實現：

void ParseDisplayName(
            IntPtr hwnd,
            IntPtr pbc,
            [MarshalAs(UnmanagedType.LPWStr)] string pszDisplayName,
            out uint pchEaten,
            out IntPtr ppidl,
            ref uint pdwAttributes);

void BindToObject(
            IntPtr pidl,
            IntPtr pbc,
            [In()] ref Guid riid,
            out IShellFolder ppv);//擷取 C 盤的 PIDL
            string FolderPath = @"C:\";
            IntPtr Pidl = IntPtr.Zero;
            IShellFolder Root;
            uint i, j = 0;
            desktop.ParseDisplayName(Handle, IntPtr.Zero, FolderPath, out i, out Pidl, ref j);
            desktop.BindToObject(Pidl, IntPtr.Zero, ref Guids.IID_IShellFolder, out Root);

前提是你應該保證路徑存在，因為我沒有做任何出錯控制。這樣我們就獲得了一個 Root，它表示C盤。通過這個Root，我們可以用 EnumObjects 來迴圈擷取其子項（子檔案和子檔案夾）：

[PreserveSig]
        int EnumObjects(IntPtr hWnd, SHCONTF flags, out IntPtr enumIDList);

//迴圈尋找 C 盤下面的檔案/檔案夾的 PIDL
            IEnumIDList fileEnum = null;
            IEnumIDList folderEnum = null;
            IntPtr fileEnumPtr = IntPtr.Zero;
            IntPtr folderEnumPtr = IntPtr.Zero;
            IntPtr pidlSub;
            int celtFetched;

            //擷取子檔案夾
            if (Root.EnumObjects(this.Handle, SHCONTF.FOLDERS | SHCONTF.INCLUDEHIDDEN, out fileEnumPtr) == API.S_OK)
            {
                fileEnum = (IEnumIDList)Marshal.GetObjectForIUnknown(fileEnumPtr);
                while (fileEnum.Next(1, out pidlSub, out celtFetched) == 0 && celtFetched == API.S_FALSE)
                {
                    //擷取顯示名稱
                    string name = API.GetNameByPIDL(pidlSub);
                    lvFile.Items.Add(name, 1);
                }
            }

            //擷取子檔案
            if (Root.EnumObjects(this.Handle, SHCONTF.NONFOLDERS | SHCONTF.INCLUDEHIDDEN, out folderEnumPtr) == API.S_OK)
            {
                folderEnum = (IEnumIDList)Marshal.GetObjectForIUnknown(folderEnumPtr);
                while (folderEnum.Next(1, out pidlSub, out celtFetched) == 0 && celtFetched == API.S_FALSE)
                {
                    string name = API.GetNameByPIDL(pidlSub);
                    lvFile.Items.Add(name, 0);
                }
            }

事實上，代碼到此結束。然而我發現有太多的結構體和枚舉沒有介紹（以後會有更多），有興趣的朋友可以自己查 MSDN ，否則就等待我下一節再介紹了。

最後把圖和代碼貼上，下一節再詳細介紹。

原始碼：/Files/lemony/WinShell.rar