IPersistFolder::Initialize method (shobjidl_core.h)

Instructs a Shell folder object to initialize itself based on the information passed.

Syntax

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Parameters

pidl

Type: LPCITEMIDLIST

The address of the ITEMIDLIST (item identifier list) structure that specifies the absolute location of the folder.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

All objects that implement the IShellFolder interface for use in the Shell's namespace must implement this method. When a folder's location in the namespace is not a relevant consideration, this method can simply return S_OK. When the location is relevant to the folder, you should store the fully qualified IDLIST passed in for later reference.

For example, if the folder implementation needs to construct a fully qualified pointer to an item identifier list (PIDL) to elements that it contains, the PIDL passed to this method should be used to construct the fully qualified PIDLs.

Requirements