IPersistFolder::Initialize
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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 |
| Windows Embedded CE | Windows CE .NET 4.2 and later |