System Global Function ConvertVariant

ConvertVariant(	const	`iVar`,
		`oObject`)

Converts a CATVariant into a C++ CATBaseDispatch.

Parameters:

iVar: the CATVariant to convert
oObject: a C++ CATBaseDispatch pointer where the converted value will be stored.
Lifecycle rules deviation:the reference count of the CATBaseDispatch object returned is not altered, so there is no need to call Release on this object after the ConvertVariant call.

Returns:

S_OK upon success, E_FAIL if the CATVariant did not actually contain a CATBaseDispatch.

This object is included in the file: CATAutoConversions.h