SHCreateShellFolderViewEx function (shlobj_core.h)

Creates a new instance of the default Shell folder view object. It is recommended that you use SHCreateShellFolderView rather than this function.

Syntax

SHSTDAPI SHCreateShellFolderViewEx(
  [in]  CSFV       *pcsfv,
  [out] IShellView **ppsv
);

Parameters

[in] pcsfv

Type: CSFV*

Pointer to a structure that describes the details used in creating this instance of the Shell folder view object.

[out] ppsv

Type: IShellView**

The address of an IShellView interface pointer that, when this function returns successfully, points to the new view object. On failure, this value is NULL.

Return value

Type: HRESULT

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

Remarks

SHCreateShellFolderView is recommended over SHCreateShellFolderViewEx because of the greater flexibility of its elements to participate in various scenarios, provide new functionality to the view, and interact with other objects.

When dealing with several instances of IShellView, you might want to verify which is the default Shell folder view object. To do so, call QueryInterface on the object using IID_CDefView. This call succeeds only on the default Shell folder view object.

Requirements

See also

SHCreateShellFolderView