Oracle Forms Developer – Form Builder Reference, Volume 1

VARPTR_TO_VAR built-in
Description
Changes a variant pointer into a simple variant.
Syntax
FUNCTION VARPTR_TO_VAR
(variant OLEVAR, vtype VT_TYPE)
RETURN changed OLEVAR;
Built-in Type unrestricted function
Returns the transformed variant.
Parameters
variant The OLE variant pointer to be changed into a variant.
vtype The OLE VT_TYPE to be given to the transformed
variant.
Usage Notes
This is an optional parameter. If not specified, the default
value is VT_VARIANT.
• This function removes VT_BYREF typing from the variant.
• If the variant’s type was not VT_BYREF, the variant is assumed to hold an address to the type
specified in the vtype, and is de-referenced accordingly.
• If the pointer was NULL or the variant was of type VT_NULL, then VT_EMPTY is returned.
453