Initializes a folder and specifies its location in the namespace. If the folder is a shortcut, this method also specifies the location of the target folder.
HRESULT InitializeEx( IBindCtx *pbc, PCIDLIST_ABSOLUTE pidlRoot, const PERSIST_FOLDER_TARGET_INFO *ppfti );
A pointer to an IBindCtx object that provides the bind context. This parameter can be NULL.
A pointer to a fully qualified PIDL that specifies the absolute location of a folder or folder shortcut. The calling application is responsible for allocating and freeing this PIDL.
Type: const PERSIST_FOLDER_TARGET_INFO*
A pointer to a PERSIST_FOLDER_TARGET_INFO structure that specifies the location of the target folder and its attributes.
If ppfti points to a valid structure, pidlRoot represents a folder shortcut.
If ppfti is set to NULL, pidlRoot represents a normal folder. In that case, InitializeEx should behave as if Initialize had been called.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
This function is an extended version of IPersistFolder::Initialize. It allows the Shell to initialize folder shortcuts as well as normal folders.
|Minimum supported client||Windows 2000 Professional with SP3, Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|
|Header||shobjidl_core.h (include Shobjidl.h)|
|DLL||Shell32.dll (version 5.0 or later)|