Edit

ITfCategoryMgr::RegisterGUID method (msctf.h)

  • Article

Adds a GUID to the internal table and obtains an atom for the GUID.

Syntax

HRESULT RegisterGUID(
  [in]  REFGUID    rguid,
  [out] TfGuidAtom *pguidatom
);

Parameters

[in] rguid

Contains the GUID to obtain the identifier for.

[out] pguidatom

Pointer to a TfGuidAtom value that receives the identifier of the GUID.

Return value

This method can return one of these values.

Value Description
S_OK
 The method was successful.
E_FAIL
 An unspecified error occurred.
E_INVALIDARG
 pguidatom is invalid.

Remarks

Identical GUID values receive identical TfGuidAtom values.

A TfGuidAtom value is only valid within the process that ITfCategoryMgr::RegisterGUID is called from.

Requirements

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

See also

ITfCategoryMgr interface, ITfCategoryMgr::GetGUID, ITfCategoryMgr::IsEqualTfGuidAtom, TfGuidAtom