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