IPersistFolder3::InitializeEx method
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.
Syntax
HRESULT InitializeEx( [in] IBindCtx *pbc, [in] LPCITEMIDLIST pidlRoot, [in] const PERSIST_FOLDER_TARGET_INFO *ppfti );
Parameters
- pbc [in]
-
Type: IBindCtx*
A pointer to an IBindCtx object that provides the bind context. This parameter can be NULL.
- pidlRoot [in]
-
Type: LPCITEMIDLIST
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.
- ppfti [in]
-
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.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This function is an extended version of IPersistFolder::Initialize. It allows the Shell to initialize folder shortcuts as well as normal folders.
Requirements
|
Minimum supported client |
Windows 2000 Professional with SP3, Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
IDL |
|
|
DLL |
|