IPersistFolder3::InitializeEx-Methode (shobjidl_core.h)

Artikel
03/04/2024

Initialisiert einen Ordner und gibt seinen Speicherort im Namespace an. Wenn der Ordner eine Verknüpfung ist, gibt diese Methode auch den Speicherort des Zielordners an.

Syntax

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

Parameter

[in] pbc

Typ: IBindCtx*

Ein Zeiger auf ein IBindCtx-Objekt , das den Bindungskontext bereitstellt. Dieser Parameter kann NULL sein.

[in] pidlRoot

Typ: LPCITEMIDLIST

Ein Zeiger auf eine vollqualifizierte PIDL, die den absoluten Speicherort eines Ordners oder einer Ordnerverknüpfung angibt. Die aufrufende Anwendung ist für die Zuweisung und Freigabe dieser PIDL verantwortlich.

[in] ppfti

Typ: const PERSIST_FOLDER_TARGET_INFO*

Ein Zeiger auf eine PERSIST_FOLDER_TARGET_INFO-Struktur , die den Speicherort des Zielordners und seine Attribute angibt.

Wenn ppfti auf eine gültige Struktur zeigt, stellt pidlRoot eine Ordnerverknüpfung dar.

Wenn ppfti auf NULL festgelegt ist, stellt pidlRoot einen normalen Ordner dar. In diesem Fall sollte sich InitializeEx so verhalten, als ob Initialize aufgerufen worden wäre.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion ist eine erweiterte Version von IPersistFolder::Initialize. Dadurch kann die Shell Sowohl Ordnerverknüpfungen als auch normale Ordner initialisieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional mit SP3, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 5.0 oder höher)

Share via