ComboBox_InsertString macro (windowsx.h)

Adds a string to a list in a combo box at the specified location. You can use this macro or send the CB_INSERTSTRING message explicitly.

Syntax

int ComboBox_InsertString(
   HWND   hwndCtl,
   int    index,
   LPCSTR lpsz
);

Parameters

hwndCtl

Type: HWND

A handle to the control.

index

Type: int

The zero-based index at which to insert the string, or –1 to add it to the end of the list.

lpsz

Type: LPCSTR

The string to add.

Return value

Type: int

The return value is the zero-based index of the string in the list. If an error occurs, the return value is CB_ERR. If there is insufficient space to store the new string, the return value is CB_ERRSPACE.

Remarks

For more information, see CB_INSERTSTRING.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header windowsx.h