IA4HierarchyFolder::GetColumnDataItem

Purpose

Returns a data field for a folder or object to be displayed in a column in the list view of the iSeries™ Navigator. This is a required member function.

Syntax

HRESULT STDMETHODCALLTYPE GetColumnDataItem(
    LPCITEMIDLIST pidl,
    LPARAM lParam,
    char * lpszColumnData,
    UINT cchMax
    );

Parameters

pidl

Pointer to an ITEMIDLIST (item identifier list) structure that uniquely identifies the object whose column data is to be obtained.

lParam

The value that was previously associated with the column for which data is requested by the component (see GetColumnInfo).

lpszColumnData

Address of the buffer that will receive the null-terminated data string.

cchMax

Size of the buffer that will receive the null-terminated data string.

Return Codes

Returns NOERROR if successful or an E_FAIL if unable to retrieve the column data.

Comments

This function is called repeatedly by the iSeries Navigator when populating a list view. Long running operations should therefore be avoided.