IShellLibrary::GetFolders メソッド (shobjidl_core.h)

[アーティクル]
03/02/2024

ライブラリに含まれる子フォルダーのセットを取得します。

構文

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

パラメーター

[in] lff

種類: LIBRARYFOLDERFILTER

取得するフォルダーを決定する次のいずれかの LIBRARYFOLDERFILTER 値。これらのフラグを組み合わせることはできません。

LFF_FORCEFILESYSTEM (1)

ファイルシステムフォルダーのみを取得します。ファイルシステムフォルダーは、 SFGAO_FILESYSTEM 属性が設定されているフォルダーです。

LFF_STORAGEITEMS (2)

IStorage オブジェクトにバインドできるすべてのフォルダーを取得します。これらのフォルダーは、 SFGAO_STORAGEまたはSFGAO_FILESYSTEM 属性が設定されているフォルダーです。

LFF_ALLITEMS (3)

ライブラリ内のすべてのフォルダーを取得します。

[in] riid

種類: REFIID

ppv で取得するインターフェイスの IID への参照。通常、この値はIID_IShellItemArrayされますが、CShellItemArray によって実装されるその他のインターフェイスのIID_IObjectCollection、IID_IObjectArray、または IID を指定することもできます。

[out] ppv

型: void**

riid で要求されたインターフェイスへのポインター。この呼び出しが失敗した場合、この値は NULL です。

戻り値

種類: HRESULT

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	呼び出しが成功し、指定されたフォルダーが ppv で返されました。
S_FALSE	呼び出しは成功しましたが、指定されたすべてのフォルダーが ppv で返されたわけではありません。
E_	このメソッドは、他のエラー値を返すことができます。

注釈

このメソッドは、フォルダーの順序付きリストを取得します。既定では、このメソッドはストレージの場所のみを返します。

最良の結果を得るには、riid パラメーターと ppv パラメーターに Objbase.h で定義されている IID_PPV_ARGS マクロを使用します。このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供します。これにより、コーディングエラーが発生する可能性がなくなります。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)