IPersistFolder::Initialize

[Now Supported on Windows NT]

The IPersistFolder::Initialize method is called whenever the Explorer is initializing a shell folder object.

HRESULT Initialize(

LPCITEMIDLIST pidl, //Folder's absolute location.
);  

Parameters

pidl

Pointer to the ITEMIDLIST (tem identifiier list) structure that specifies the absolute location of the folder.

Return Values

Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks

Notes to Implementors

All objects that implement IShellFolder for use in the shell's name space must implement this method. When a folder's location in the name space is not a relevant consideration, Initialize can simply return NOERROR. When the location is relevant to the folder, you should store the fully qualified IDLIST passed in for future reference.

For example, if the folder implementation needs to construct a fully qualified PIDL to elements that it contains, the PIDL passed to Initialize should be used to construct those fully qualified PIDLs.

See Also

IPersistFolder, IShellExtInit, IShellFolder, ITEMIDLIST