IPersistFolder::Initialize method (shobjidl_core.h)
Instructs a Shell folder object to initialize itself based on the information passed.
HRESULT Initialize( PCIDLIST_ABSOLUTE pidl );
The address of the ITEMIDLIST (item identifier list) structure that specifies the absolute location of the folder.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
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.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||shobjidl_core.h (include Shobjidl.h)|
|DLL||Shell32.dll (version 4.0 or later)|