IShellLibrary：：GetFolders 方法 (shobjidl_core.h)

取得連結庫中所包含的子資料夾集合。

語法

HRESULT GetFolders(
  [in]  LIBRARYFOLDERFILTER lff,
  [in]  REFIID              riid,
  [out] void                **ppv
);

[in] lff

下列其中一個 LIBRARYFOLDERFILTER 值，決定要取得的資料夾。這些旗標無法合併。

只取得檔案系統資料夾。檔案系統資料夾是已設定SFGAO_FILESYSTEM 屬性的資料夾。

取得可系結至 IStorage 物件的所有資料夾。這些資料夾是具有 SFGAO_STORAGE 或SFGAO_FILESYSTEM屬性集的資料夾。

取得文件庫中的所有資料夾。

[in] riid

類型： REFIID

在 ppv 中取得之介面 IID 的參考。此值通常是IID_IShellItemArray，但也可以IID_IObjectCollection、IID_IObjectArray或 CShellItemArray 所實作之任何其他介面的 IID。

[out] ppv

類型： void**

riid 中要求的介面指標。如果此呼叫失敗，此值為 NULL。

類型： HRESULT

這個方法可以傳回其中一個值。

這個方法會取得資料夾的已排序列表。根據預設，此方法只會傳回儲存位置。

為了獲得最佳結果，請使用在 Objbase.h 中定義的 IID_PPV_ARGS 宏，以取得 riid 和 ppv 參數。此宏會根據 ppv 中值所指向的介面提供正確的 IID，這可消除編碼錯誤的可能性。