IShellFolder::EnumObjects

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This method allows a client to determine the contents of a folder by creating an item identifier enumeration object and returning its IEnumIDList interface. The methods supported by that interface can be used to enumerate the folder's contents.

Syntax

HRESULT EnumObjects(
  HWND hwndOwner,
  SHCONTF grfFlags,
  IENUMIDLIST** ppenumIDList
);

Parameters

• hwndOwner
  [in] Window handle that the enumeration object should use as that parent window to take user input, if user input is required. An example would be a dialog box that asks for a password or prompts the user to insert a CD or floppy disk. If hwndOwner is set to NULL, the enumerator should not post any messages. If user input is required, it should silently fail.

• grfFlags
  [in] Flags indicating which items to include in the enumeration. For a list of possible values, see the SHCONTF enumerated type.

• ppenumIDList
  [out] Address that receives a pointer to the IEnumIDList interface of the enumeration object created by this method. If an error occurs, ppenumIDList is set to NULL.

Return Value

Returns NOERROR if successful, or an error value otherwise.

Remarks

The calling application must free the returned IEnumIDList object by calling its Release method.

Requirements

See Also

Reference

IShellFolder
SHGetDesktopFolder