ITfLangBarItemMgr::GetItemsStatus method (ctfutb.h)

Article
02/22/2024

Obtains the status of one or more items on the language bar.

Syntax

HRESULT GetItemsStatus(
  [in]  ULONG      ulCount,
  [in]  const GUID *prgguid,
  [out] DWORD      *pdwStatus
);

Parameters

[in] ulCount

Specifies the number of items to obtain the status for.

[in] prgguid

Pointer to an array of GUIDs that identify the items obtain the status for. These are the item GUIDs that the item supplies in ITfLangBarItem::GetInfo. This array must be at least ulCount elements in length.

[out] pdwStatus

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.

The index of each status value corresponds to the index of the item identifier in prgguid. For example, the element 0 in pdwStatus receives the for the item identified by element 0 of prgguid.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.
E_FAIL	An unspecified error occurred.

Remarks

This method causes the ITfLangBarItem::GetStatus method of each language bar item identified by prgguid to be called.

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