IPersistFolder::Initialize-Methode (shobjidl_core.h)

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