IA4HierarchyFolder::GetListObject

Purpose

Given a fully-qualified object name, this function returns a pointer to a cached proxy object created by the plug-in. This is an optional member function.

Syntax

HRESULT STDMETHODCALLTYPE GetListObject(
    const char * lpszObjectName,
    LPVOID* ppvObj
    ); 

Parameters

lpszObjectName

The fully-qualified object name for which a list object will be returned.

ppvObj

The returned pointer to an implementation-defined object. The calling routine should cast this pointer to an appropriate object type.

Return Codes

Returns NOERROR if successful or E_NOTIMPL if you choose not to implement the function.

Comments

Calls to this function occur whenever your plug-in code calls cwbUN_GetListObjectFromName or cwbUN_GetListObjectFromPidl to obtain a "proxy" object that was instantiated by the Activate method. The plug-in uses this proxy object to access data on the iSeries™ server, or to perform actions on the iSeries server. Because IA4HierarchyFolder implementation maintains the cache of proxy objects, the calling program should not attempt to delete the object.