IShellFolder::EnumObjects

[Now Supported on Windows NT]

Determines the contents of a folder by creating an item enumeration object (a set of item identifiers) that can be retrieved using the IEnumIDList interface.

HRESULT EnumObjects(

HWND hwndOwner, // Handle of owner window
DWORD grfFlags, // ems to include in enumeration
LPENUMIDLIST *ppenumIDList // Pointer to IEnumIDList
);  

Parameters

hwndOwner

Handle of the owner window that the client should specify if it displays a dialog box or message box.

grfFlags

Flags determining which items to iclude in the enumeration. For a list of possible values, see the description of the SHCONTF type.

ppenumIDList

Address that receives a pointer to the IEnumIDList interface created by this method. If an error occurs, a NULL pointer is returned in this address.

Return Values

Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks

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

This method is similar to the method defined by OLE.

See Also

IEnumIDList, IOleContainer::EnumObjects, IShellFolder, SHGetDeskTopFolder