IShellFolder::EnumObjects  1.06841

[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 IEnumIDList1ISB44O 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 SHCONTF5URQ.TK type.

ppenumIDList

Address that receives a pointer to the IEnumIDList1ISB44O 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