Επεξεργασία

Κοινή χρήση μέσω


IPersistFolder::Initialize method (shobjidl_core.h)

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

Syntax

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Parameters

pidl

Type: LPCITEMIDLIST

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

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

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.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 4.0 or later)