IShellFolder インターフェイス (shobjidl_core.h)

すべてのシェル名前空間フォルダー オブジェクトによって公開され、そのメソッドはフォルダーの管理に使用されます。

継承

IShellFolder インターフェイスは、IUnknown インターフェイスから継承されます。 IShellFolder には、次の種類のメンバーもあります。

メソッド

IShellFolder インターフェイスには、これらのメソッドがあります。

IShellFolder::BindToObject ハンドラー (通常は、特定のアイテムの IShellFolder を実装する Shell フォルダー オブジェクト) を取得します。 ハンドラーの構築を制御する省略可能なパラメーターは、バインド コンテキストで渡されます。
IShellFolder::BindToStorage オブジェクトのストレージ インターフェイスへのポインターを要求します。
IShellFolder::CompareIDs アイテム識別子リストを指定して、2 つのファイル オブジェクトまたはフォルダーの相対順序を決定します。
IShellFolder::CreateViewObject フォルダー オブジェクトから情報を取得したり、フォルダー オブジェクトと対話したりするために使用できるオブジェクトを要求します。
IShellFolder::EnumObjects アイテム識別子列挙オブジェクトを作成し、その IEnumIDList インターフェイスを返すことによって、クライアントがフォルダーの内容を確認できるようにします。 そのインターフェイスでサポートされているメソッドを使用して、フォルダーの内容を列挙できます。
IShellFolder::GetAttributesOf IShellFolder で表される オブジェクトに含まれる 1 つ以上のファイル オブジェクトまたはフォルダー オブジェクトの属性を取得します。
IShellFolder::GetDisplayNameOf 指定したファイル オブジェクトまたはサブフォルダーの表示名を取得します。
IShellFolder::GetUIObjectOf 指定したファイル オブジェクトまたはフォルダーに対してアクションを実行するために使用できる オブジェクトを取得します。
IShellFolder::P arseDisplayName ファイル オブジェクトまたはフォルダーの表示名をアイテム識別子リストに変換します。
IShellFolder::SetNameOf ファイル オブジェクトまたはサブフォルダーの表示名を設定し、プロセス内の項目識別子を変更します。

注釈

シェルの名前空間を拡張するオブジェクトに対して、このインターフェイスを実装します。 たとえば、ルート化された Windows エクスプローラーを必要とする別の名前空間を作成したり、システム名前空間の階層内に新しい名前空間を直接インストールしたりするには、このインターフェイスを実装します。 名前空間の内容に最も慣れているので、データにアクセスするために必要なすべてのものを実装する責任があります。

シェルの名前空間の内容に対して操作を表示または実行する必要がある場合は、このインターフェイスを使用します。 IShellFolder をサポートするオブジェクトは、通常、他の Shell フォルダー オブジェクトによって作成されます。 フォルダーの IShellFolder インターフェイスを取得するには、通常、 SHGetDesktopFolder を呼び出すことから始めます。 この関数は、デスクトップの IShellFolder インターフェイスへのポインターを返します。 その後、そのメソッドを使用して、特定の名前空間フォルダーの IShellFolder インターフェイスを取得できます。

メモIShellFolder メソッドは、フォルダーに対して相対的な PIDL のみを受け入れます。 IShellFolder::GetAttributesOf などの一部の IShellFolder メソッドは、単一レベルの PIDL のみを受け入れます。 言い換えると、PIDL には、1 つの SHITEMID 構造体と終端 の NULL のみを含める必要があります。 IEnumIDList を使用してフォルダーの内容を列挙すると、このフォームの PID が表示されます。 IShellFolder::CompareIDs などの他のメソッドは、複数レベルの PIDL を受け入れます。 これらの PIDL は、複数 の SHITEMID 構造体を持ち、親フォルダーの下の 1 つ以上のレベルのオブジェクトを識別できます。 参照を調べて、特定のメソッドで受け入れられる PIDL の種類を確認します。

 

例

IShellFolder の実装例は、エクスプローラー データ プロバイダーのサンプル サンプルで確認できます。 さまざまな IShellFolder メソッドの使用は、 ファイル操作のサンプルなど、いくつかのサンプルで確認できます。

要件

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