4.12 The OLE-AUTOMATION module
copy-automation-value
Function
Summary
Copies a C-allocated value into an equivalent Dylan object.
Signature
copy-automation-value object => object
Arguments
- object
- An instance of
<object>.
Values
- object
- An instance of
<object>.
Description
Copies a C-allocated value into an equivalent Dylan object.
If the argument is an instance of <BSTR>, <ole-vector>, or <ole-array>, the value returned is a Dylan object that has the same contents but does not use any C-allocated storage. If the argument is of any other type, it is returned unchanged.
For example, the contents of an <ole-vector> would be copied into a <simple-vector>, with copy-automation-value being recursively called on each element.
A dispatch method could use this method to ensure that an argument value it has received can be kept after the call returns. A controller could use it on a property value or dispatch method result that it receives.