IShellFolder-Schnittstelle (shobjidl_core.h)

Die von allen Shell-Namespaceordnerobjekten verfügbar gemachten Methoden werden zum Verwalten von Ordnern verwendet.

Vererbung

Die IShellFolder-Schnittstelle erbt von der IUnknown-Schnittstelle . IShellFolder verfügt auch über die folgenden Membertypen:

Methoden

Die IShellFolder-Schnittstelle verfügt über diese Methoden.

IShellFolder::BindToObject Ruft einen Handler ab, in der Regel das Shell-Ordnerobjekt, das IShellFolder für ein bestimmtes Element implementiert. Optionale Parameter, die die Konstruktion des Handlers steuern, werden im Bindungskontext übergeben.
IShellFolder::BindToStorage Fordert einen Zeiger auf die Speicherschnittstelle eines Objekts an.
IShellFolder::CompareIDs Bestimmt die relative Reihenfolge von zwei Dateiobjekten oder Ordnern unter Berücksichtigung ihrer Elementbezeichnerlisten.
IShellFolder::CreateViewObject Fordert ein Objekt an, das zum Abrufen von Informationen aus einem Ordnerobjekt oder zum Interagieren mit einem Ordnerobjekt verwendet werden kann.
IShellFolder::EnumObjects Ermöglicht es einem Client, den Inhalt eines Ordners zu bestimmen, indem er ein Elementbezeichner-Enumerationsobjekt erstellt und seine IEnumIDList-Schnittstelle zurückgibt. Die von dieser Schnittstelle unterstützten Methoden können dann verwendet werden, um den Inhalt des Ordners aufzulisten.
IShellFolder::GetAttributesOf Ruft die Attribute eines oder mehrerer Datei- oder Ordnerobjekte ab, die in dem von IShellFolder dargestellten Objekt enthalten sind.
IShellFolder::GetDisplayNameOf Ruft den Anzeigenamen für das angegebene Dateiobjekt oder unterordner ab.
IShellFolder::GetUIObjectOf Ruft ein -Objekt ab, mit dem Aktionen für die angegebenen Dateiobjekte oder Ordner ausgeführt werden können.
IShellFolder::P arseDisplayName Übersetzt den Anzeigenamen eines Dateiobjekts oder Ordners in eine Elementbezeichnerliste.
IShellFolder::SetNameOf Legt den Anzeigenamen eines Dateiobjekts oder Unterordners fest, und ändert den Elementbezeichner im Prozess.

Hinweise

Implementieren Sie diese Schnittstelle für Objekte, die den Namespace der Shell erweitern. Implementieren Sie beispielsweise diese Schnittstelle, um einen separaten Namespace zu erstellen, der eine windows-Explorer erfordert, oder um einen neuen Namespace direkt in der Hierarchie des Systemnamespaces zu installieren. Sie sind mit den Inhalten Ihres Namespace am besten vertraut, sodass Sie für die Implementierung aller Erforderlichen für den Zugriff auf Ihre Daten verantwortlich sind.

Verwenden Sie diese Schnittstelle, wenn Sie einen Vorgang für den Inhalt des Shell-Namespace anzeigen oder ausführen müssen. Objekte, die IShellFolder unterstützen, werden normalerweise von anderen Shell-Ordnerobjekten erstellt. Um die IShellFolder-Schnittstelle eines Ordners abzurufen, rufen Sie in der Regel SHGetDesktopFolder auf. Diese Funktion gibt einen Zeiger auf die IShellFolder-Schnittstelle des Desktops zurück. Anschließend können Sie die zugehörigen Methoden verwenden, um eine IShellFolder-Schnittstelle für einen bestimmten Namespaceordner abzurufen.

HinweisIShellFolder-Methoden akzeptieren nur PIDLs, die relativ zum Ordner sind. Einige IShellFolder-Methoden , z. B. IShellFolder::GetAttributesOf, akzeptieren nur PIDLs auf einzeler Ebene. Mit anderen Worten: Die PIDL darf nur eine einzelne SHITEMID-Struktur plus das beendende NULL enthalten. Wenn Sie den Inhalt eines Ordners mit IEnumIDList auflisten, erhalten Sie PIDLs dieses Formulars. Andere Methoden, z. B. IShellFolder::CompareIDs, akzeptieren PIDLs auf mehreren Ebenen. Diese PIDLs können mehrere SHITEMID-Strukturen aufweisen und Objekte auf einer oder mehreren Ebenen unterhalb des übergeordneten Ordners identifizieren. Überprüfen Sie den Verweis, um sicherzustellen, welcher PIDL-Typ von einer bestimmten Methode akzeptiert werden kann.

 

Beispiele

Eine Beispielimplementierung von IShellFolder finden Sie im Beispiel für Explorer-Datenanbieter. Die Verwendung verschiedener IShellFolder-Methoden finden Sie in mehreren Beispielen, einschließlich Beispiel für Dateivorgänge.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h