GetCollectionItem method

Syntax

Invoke GetCollectionItem, hHandle, lItem, lpszBuffer

Function

Gets the contents of an item (string) from a collection.

Parameters

hHandle

Handle to the collection.

lItem

Zero-based index of the item to be retreived.

lpszBuffer

Pointer to a buffer that will received the item contents. The buffer must have sufficient space for the string and a terminating null character.

Return value

Eax returns the length of the string, in characters, excluding the terminating null character.

REMARKS: If lItem does not specify a valid item, the return value is -1.