SHGetDesktopFolder function

Retrieves the IShellFolder interface for the desktop folder, which is the root of the Shell's namespace.

Syntax

HRESULT SHGetDesktopFolder(
  _Out_ IShellFolder **ppshf
);

Parameters

ppshf [out]

Type: IShellFolder**

When this method returns, receives an IShellFolder interface pointer for the desktop folder. The calling application is responsible for eventually freeing the interface by calling its IUnknown::Release method.

Return value

Type: HRESULT

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

Requirements