CA_DuplicateObjHandle
HRESULT CA_DuplicateObjHandle (CAObjHandle objectHandle, const IID *interfaceId, CAObjHandle *newObjectHandle);
Purpose
Creates a new CAObjHandle from an existing CAObjHandle.
The new CAObjHandle inherits multithreading support and locale settings from the existing CAObjHandle.
Parameters
| Input | ||
| Name | Type | Description |
| objectHandle | CAObjHandle | An ActiveX Object handle returned by one of the object creation functions in this library or by an ActiveX server method. |
| interfaceId | const IID * | The interface id specifying the type of the interface pointer to be stored in
the new object handle. You must pass the UUID of an interface implemented by the object passed in the objectHandle parameter or zero to indicate the current interface id that is stored in that object handle. |
| Output | ||
| Name | Type | Description |
| newObjectHandle | CAObjHandle | The duplicated object handle. Use this handle to call methods or get and set properties of this ActiveX object. When this handle is no longer needed, discard it by calling CA_DiscardObjHandle. |
Return Value
| Name | Type | Description |
| status | HRESULT | A value indicating whether an error occurred. Negative error codes indicate function failure. Error codes are defined in CVIversion\include\cviauto.h and <Program Files>\National Instruments\Shared\MSDTRedistributables\SDKHeaderFiles\8.1\winerror.h. The LabWindows/CVI ActiveX Library explicitly returns error codes. Other error codes in winerror.h are generated by ActiveX servers and passed on to you by the LabWindows/CVI ActiveX Library. You can use CA_GetAutomationErrorString to get the description of an error code or CA_DisplayErrorInfo to display the description of the error code. |
Additional Information
Library: ActiveX Library
Include file: cviauto.h
LabWindows/CVI compatibility: LabWindows/CVI 5.5 and later