Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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

Shobjidl.h

IDL

Shobjidl.idl

DLL

Shell32.dll (version 5.0 or later)

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.