ITfLangBarItemMgr::GetItems method (ctfutb.h)

Obtains the interface, information and status for one or more items in the language bar.

Syntax

HRESULT GetItems(
  [in]  ULONG              ulCount,
  [out] ITfLangBarItem     **ppItem,
        TF_LANGBARITEMINFO *pInfo,
        DWORD              *pdwStatus,
        ULONG              *pcFetched
);

Parameters

[in] ulCount

Specifies the number of items to obtain the status for.

[out] ppItem

Pointer to an array of ITfLangBarItem interface pointers that receive the item interfaces. This array must be at least ulCount elements in length.

pInfo

[in, out] Pointer to an array of TF_LANGBARITEMINFO structures that receive the information for each item. This array must be at least ulCount elements in length.

pdwStatus

[in, out] Pointer to an array of DWORD values that receive the status of each item. Each element in this array receives zero or a combination of one or more of the TF_LBI_STATUS_* values. This array must be at least ulCount elements in length.

pcFetched

[in, out] Pointer to a ULONG that receives the number of items obtained by this method. This parameter can be NULL if this information is not required.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.
S_FALSE	The number of items obtained is less than the number of items requested. If pcFetched is not NULL, pcFetched receives the number of items obtained.
E_FAIL	An unspecified error occurred.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ctfutb.h
DLL	Msctf.dll
Redistributable	TSF 1.0 on Windows 2000 Professional

See also

ITfLangBarItem

ITfLangBarItemMgr

TF_LANGBARITEMINFO

TF_LBI_STATUS_* Constants