IShellFolderView::GetSelectedObjects method (shlobj_core.h)

Article
02/22/2024

[This method has been deprecated. Use IFolderView2::GetSelection instead.]

Gets an array of the objects in the view that are selected and the number of those objects.

Syntax

HRESULT GetSelectedObjects(
  [out] PCUITEMID_CHILD **pppidl,
  [out] UINT            *puItems
);

Parameters

[out] pppidl

Type: PCUITEMID_CHILD**

The address of a pointer that, when this method returns successfully, points to an array of the currently selected items in the view. The calling application is expected to free the array at pppidl using LocalFree. The calling application must not free the individual items contained in the array.

[out] puItems

Type: UINT*

A pointer to a value that, when this method returns successfully, receives the number of items in the pppidl array.

Return value

Type: HRESULT

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

Remarks

This method provides constant pointers to internal data structures. The calling application is expected to act on them immediately and not cache them.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	shlobj_core.h

Share via