IShellFolder 介面 (shobjidl_core.h)

由所有Shell命名空間資料夾物件公開，其方法會用來管理資料夾。

繼承

IShellFolder 介面繼承自 IUnknown 介面。 IShellFolder 也有下列類型的成員：

方法

IShellFolder 介面具有這些方法。

IShellFolder：：BindToObject 擷取處理程式，通常是實作特定專案的 IShellFolder 的 Shell 資料夾物件。 控制處理程式建構的選擇性參數會在系結內容中傳遞。
IShellFolder：：BindToStorage 要求對象的儲存介面指標。
IShellFolder：：CompareIDs 決定兩個檔案物件或資料夾的相對順序，指定其專案識別符清單。
IShellFolder：：CreateViewObject 要求物件，該物件可用來取得或與資料夾物件互動的資訊。
IShellFolder：：EnumObjects 可讓客戶端藉由建立專案標識碼列舉物件並傳回其 IEnumIDList 介面，來判斷資料夾的內容。 然後，該介面所支援的方法可用來列舉資料夾的內容。
IShellFolder：：GetAttributesOf 取得 IShellFolder 所表示之 物件中包含的一或多個檔案或資料夾物件的屬性。
IShellFolder：：GetDisplayNameOf 擷取指定之檔案物件或子資料夾的顯示名稱。
IShellFolder：：GetUIObjectOf 取得 對象，這個物件可用來對指定的檔案物件或資料夾執行動作。
IShellFolder：:P arseDisplayName 將檔案對象的顯示名稱或資料夾轉譯成專案識別碼清單。
IShellFolder：：SetNameOf 設定檔案物件或子資料夾的顯示名稱，變更程式中的項目識別元。

備註

針對擴充Shell命名空間的物件實作這個介面。 例如，實作此介面來建立需要根 Windows 檔案總管的個別命名空間，或直接在系統命名空間階層中安裝新的命名空間。 您最熟悉命名空間的內容，因此您必須負責實作存取數據所需的一切。

當您需要在Shell命名空間的內容上顯示或執行作業時，請使用這個介面。 支援 IShellFolder 的物件通常是由其他 Shell 資料夾物件所建立。 若要擷取資料夾的 IShellFolder 介面，您通常會從呼叫 SHGetDesktopFolder 開始。 此函式會傳回桌面 IShellFolder 介面的指標。 然後，您可以使用其方法來擷取特定命名空間資料夾的 IShellFolder 介面。

注意IShellFolder 方法只接受相對於資料夾的PIDL。 某些 IShellFolder 方法，例如 IShellFolder：：GetAttributesOf，只接受單一層級的 PIDL。 換句話說，PIDL 必須只包含單一 SHITEMID 結構，加上終止 的 NULL。 當您使用 IEnumIDList 列舉資料夾的內容時，您會收到此表單的 PIDL。 其他方法，例如 IShellFolder：：CompareID，接受多層級的 PID。 這些 PIDL 可以有多個 SHITEMID 結構，並識別父資料夾下方一或多個層級的物件。 請檢查參考以確定特定方法可以接受何種類型的 PIDL。

 

例子

您可以在總管數據提供者範例範例中看到 IShellFolder 的範例實作。 您可以在數個範例中找到各種 IShellFolder 方法的使用方式，包括 檔案作業範例。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h