XLL+ Class Library (7.0)


Creates a handle for an object.

virtual std::tstring MakeHandle(
   const T* pObject,
   const TCHAR* pszKey,
   long lState



The object whose handle is being created.


The key that uniquely identifies the object. The key is always in the form of a GUID, e.g.: {A6CBD52A-040D-4990-89EF-41A6721BADC6}.


The state number that specifies the stored state of the object.

Return Value

The function returns the handle as a text string. The handle must contain the key and the state, such that they can be extracted by SplitHandle.


This method is called by the HandleCache<T> object when it converts creates a handle for a newly created object. The handle created must be of a form which can be parsed by SplitHandle, so that the key and the state can be extracted.

The default implementation returns the key and the state, joined by a colon. Implementations in derived classes can insert useful information into the handle, such as the type and the name.


Header: rtdhandles.h

See Also

CHandleFormatter<T> Class | CHandleFormatter<T> Methods