XLL+ Class Library (6.3)

CHandleFormatter<T>::SplitHandle

Parses a handle and returns the guid and state.

virtual bool SplitHandle(
   const TCHAR* pszHandle,
   std::tstring& strKey,
   long& lState
);

Parameters

pszHandle

A handle, as displayed in an Excel cell.

strKey

The key that is extracted from the handle is placed into strKey. The key is always in the form of a GUID, e.g.: {A6CBD52A-040D-4990-89EF-41A6721BADC6}.

lState

The state number that is extracted from the handle is placed into lState.

Return Value

Returns true if the conversion succeeded, or false if the handle could not be successfully parsed.

Remarks

This method is called by the HandleCache<T> object when it converts a handle argument into a pointer to an object of type T.

Requirements

Header: rtdhandles.h

See Also

CHandleFormatter<T> Class | CHandleFormatter<T> Methods