Share via

IPersistFolder::Initialize (Compact 2013)

  • Article

3/28/2014

This method instructs a shell folder object to initialize itself based on the information passed.

Syntax

HRESULT Initialize(
  LPCITEMIDLIST pidl
);

Parameters

  • pidl
    Address of the ITEMIDLIST structure that specifies the absolute location of the folder.

Return Value

Returns NOERROR 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 NOERROR. When the location is relevant to the folder, you should store the fully qualified ITEMIDLIST 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

Header

shobjidl.h,
shobjidl.idl

Library

Developer Implemented

See Also

Reference

IPersistFolder
ITEMIDLIST
IShellFolder