LabWindows/CVI

Table of Contents
  • LabWindows/CVI Fundamentals
  • Creating Applications
  • Distributing Applications
  • Library Reference
  • Programmer Reference
  • Hardware Information

FPGenInsertClassInTree

FPGenInsertClassInTree

LabWindows/CVI ActiveX Server Interface

CVI_AppFPGenInsertClassInTree (CAObjHandle objectHandle, ERRORINFO *errorInfo, long treeId, const char *className, long prevNodeIndex, long asChild, const char *classHelp, long *classIndex, long *returnValue);


Note  This function signature is shown as it appears when you create a client using the LabWindows/CVI ActiveX Controller Wizard. If you create a client for the LabWindows/CVI ActiveX server interface using a different development environment, this function might be exposed differently. Some of the parameters documented here, such as objectHandle or errorInfo, are not applicable if you write a client using a different development environment.

Purpose

Inserts a class in a function tree. Pass –1 for prevNodeIndex to insert the class at the end of the tree.

Parameters

Input
Name Type Description
objectHandle CAObjHandle Specifier for a particular ActiveX object that is currently in memory. Obtain this handle from CVI_NewApp, CVI_OpenApp, CVI_ActiveApp, or an ActiveX method or property.

All of the methods that you can apply to a particular object are grouped under a single class in the function tree. The name of the class corresponds to the type of the object to which this handle refers.
treeId long Specifier for a particular function tree that is currently in memory. Obtain this ID from FPGenCreateFunctionTree or FPGenOpenFunctionTree.
className const char * The name of the class to insert in the tree.
prevNodeIndex long The zero-based index of the relative of the specified class. With asChild, this parameter determines where to insert the specified class. Pass –1 to insert the specified class at the end of the function tree.
asChild long Specifies whether to insert the specified class as a child or a sibling of prevNodeIndex.

0 = insert the specified class as a sibling of prevNodeIndex
1 = insert the specified class as a child of prevNodeIndex
classHelp const char * The help string associated with the specified class.
Output
Name Type Description
errorInfo ERRORINFO * When an ActiveX server function fails with the error code DISP_E_EXCEPTION, descriptive information about the error code is stored in this parameter. The information can include the error code, source, and description. It also can include a help file and help file context ID.

When an ActiveX server function fails with the error codes DISP_E_PARAMNOTFOUND, DISP_E_TYPEMISMATCH, or E_INVALIDARG, the parameter position of the invalid argument may be stored in the errorParamPos member of this parameter.

You can pass NULL for this parameter.
classIndex long * The zero-based index of the inserted class.
returnValue long * The value that the LabWindows/CVI ActiveX server function returns. A negative value indicates that the LabWindows/CVI ActiveX server function returned an error.

You can use GetCVIAutomationServerErrorString to get the description of a LabWindows/CVI ActiveX server error code.

Return Value

Name Type Description
status HRESULT A value indicating whether an error occurred. A negative error code indicates function failure.

Error codes are defined in CVIversion\include\cviauto.h and <Program Files>\National Instruments\Shared\MSDTRedistributables\SDKHeaderFiles\8.1\winerror.h.

You can use CA_GetAutomationErrorString to get the description of an ActiveX Library error code.

Log in to get a better experience