IPersistFolder::Initialize-Methode (shobjidl_core.h)

Artikel
03/04/2024

Weist ein Shellordnerobjekt an, sich basierend auf den übergebenen Informationen selbst zu initialisieren.

Syntax

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Parameter

pidl

Typ: LPCITEMIDLIST

Die Adresse der ITEMIDLIST-Struktur (Elementbezeichnerliste), die den absoluten Speicherort des Ordners angibt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Alle Objekte, die die IShellFolder-Schnittstelle für die Verwendung im Shell-Namespace implementieren, müssen diese Methode implementieren. Wenn der Speicherort eines Ordners im Namespace kein relevanter Aspekt ist, kann diese Methode einfach S_OK zurückgeben. Wenn der Speicherort für den Ordner relevant ist, sollten Sie die vollqualifizierte IDLIST speichern, die für einen späteren Verweis übergeben wurde.

Wenn die Ordnerimplementierung beispielsweise einen vollqualifizierten Zeiger auf eine Elementbezeichnerliste (PIDL) auf die enthaltenen Elemente erstellen muss, sollte die an diese Methode übergebene PIDL zum Erstellen der vollqualifizierten PIDLs verwendet werden.

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 (einschließlich Shobjidl.h)
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über