ISearchItem::GetParentFolder method

Gets the ISearchItem object if the URL represents an actual Shell data source (also known as a Shell namespace extension).

Syntax

HRESULT GetParentFolder(
  [out] ppShellFolder **IShellFolder,
  [out] ppidl         *LPITEMIDLIST
);

Parameters

IShellFolder [out]

Type: ppShellFolder**

On return, contains the address of a pointer to the folder that contains the current URL. IShellFolder Interface is exposed by all Shell namespace folder objects, and its methods are used to manage folders.

LPITEMIDLIST [out]

Type: ppidl*

On return, contains the address of a pointer to an item identifier list (PIDL) that identifies the parent folder. The LPITEMIDLIST parameter can refer to an object at any level below the parent folder in the namespace hierarchy, and can thus be a multi-level pointer to a pidl relative to the parent folder.

Return value

Type: HRESULT

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

Remarks

The ISearchItem::GetParentFolder method is supported only on Windows XP and Windows Server 2003, and should no longer be used.

To preview attachments with a third-party protocol handler on computers running Windows XP or Windows Server 2003, it may be necessary to use the ISearchItem interface, and the following APIs: the IItemPreviewerExt, IItemPropertyBag, and ISearchProtocolUI interfaces, the LINKINFO structure, and the LINKTYPE enumeration.

Requirements

See also

ISearchItem