XLL+ Class Library (6.3)

CHandleFormatter<T>::MakeHandle

Creates a handle for an object.

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

Parameters

pObject

The object whose handle is being created.

pszKey

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

lState

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.

Remarks

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.

Requirements

Header: rtdhandles.h

See Also

CHandleFormatter<T> Class | CHandleFormatter<T> Methods