InsertCollectionItem method


Prototype

InsertCollectionItem Proto hHandle:HANDLE, lIndex:LONG, lpszString:LPSTR

Syntax

Invoke InsertCollectionItem, hHandle, lIndex, lpszString

Function

Inserts a new item (string) into a collection.

Parameters

hHandle

Handle to the collection.

lItem

The zero-based index of the position at which to insert the item.

lpszString

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

Return value

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


REMARKS: The InsertCollectionItem method expects lpszString to be a Unicode string if the application is running as Unicode, or an ANSI string if not (see the IsAppUnicode method). You can call InsertCollectionItemA to insert ANSI strings in Unicode applications, or InsertCollectionItemW to insert Unicode strings in ANSI applications.