Object Parameters

The Object category includes the ActiveX Automation IDispatch Pointer, ActiveX Automation IUnknown Pointer, and LabWindows/CVI ActiveX Automation Handle data types. Use these types to pass a reference to a TestStand object to the DLL function. You can also use these types to pass the value of an object reference property to the DLL function.

If you specify an object reference property as the value of an object parameter, TestStand passes the value of the property. Otherwise, TestStand passes a reference to the property object you specify. The DLL function can use the property object reference in conjunction with the TestStand API to get and set the values of properties in the object, to add properties to the object, and so on.

Pass by Value or by Reference

When you select the Object category for a parameter, the C/C++ DLL Adapter displays the Pass control. This control specifies whether TestStand passes the value of the argument you specify in the Value Expression control or passes a pointer to the argument. If you select By Pointer (*) or By Reference (&) , the C/C++ DLL Adapter passes a pointer to the argument value.

If you choose to pass a pointer, the argument you specify in the Value Expression control must be the name of a variable or property.

See Also

Mapping Parameters

Pointers and Handles in 32-bit TestStand and 64-bit TestStand

Representing Pointers in Sequences in 32-bit TestStand and 64-bit TestStand

Representing Pointer-Sized Numbers in Sequences in 32-bit TestStand and 64-bit TestStand

TestStand ActiveX API Overview