AddCollectionItem method

Syntax

Invoke AddCollectionItem, hHandle, lpszString

Function

Adds a new item (string) to a collection.

Parameters

hHandle

Handle to the collection.

lpszString

Pointer to the effective address of the null-terminated string to be added.

Return value

Eax returns the zero-based index of the added string in the collection.

REMARKS: If the collection was created with the bSorted parameter set to TRUE (see the CreateCollection method) the string is inserted into the collection and the collection is sorted. Otherwise, the string is added to the end of the collection.