IPersistFolder2::Initialize Method

  • Article

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

Syntax

HRESULT Initialize(      
    LPCITEMIDLIST pidl
);

Parameters

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

Return Value

Returns S_OK if successful, or an error value otherwise.

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.