IKnownFolder::GetShellItem method (shobjidl_core.h)

Retrieves the location of a known folder in the Shell namespace in the form of a Shell item (IShellItem or derived interface).

Syntax

HRESULT GetShellItem(
  [in]  DWORD  dwFlags,
        REFIID riid,
  [out] void   **ppv
);

[in] dwFlags

Type: DWORD

Flags that specify special retrieval options. This value can be 0; otherwise, one or more of the KNOWN_FOLDER_FLAG values.

riid

Type: REFIID

A reference to the IID of the requested interface.

[out] ppv

Type: void**

When this method returns, contains the interface pointer requested in riid. This is typically IShellItem or IShellItem2.

Type: HRESULT

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

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)