SetProjectRunTimeBinding

Download PDF

Updated2023-02-21
2 minute(s) read

LabWindows/CVI ActiveX Server Interface

CVI_AppSetProjectRunTimeBinding (CAObjHandle objectHandle, ERRORINFO *errorInfo, enum CVIEnum_CVIRunTimeBinding runTimeBinding, 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

Sets the run-time binding for all build configurations of the current project. This function returns CVI_SRVR_E_CANNOT_SET_RUNTIME_BINDING if the project target type is a static library.

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.
runTimeBinding	enum CVIEnum_CVIRunTimeSupport	The type of run-time binding for the current project. You can specify one of the following constants: CVI_RUNTIME_BINDING_SHARED (0)—Binds the executable or DLL to the default, LabWindows/CVI Shared Runtime. CVI_RUNTIME_BINDING_SXS_FOR_ENTIRE_APP (1)—This option is only valid for executables. Binds the entire application to a LabWindows/CVI Side-by-Side Runtime. The executable and any DLLs in the application bound to the default, shared Runtime use the version of the LabWindows/CVI Side-by-Side Runtime to which the executable is bound. CVI_RUNTIME_BINDING_SXS_FOR_EXE_OR_DLL_ONLY (2)—Binds the executable or the DLL to the LabWindows/CVI Side-by-Side Runtime. Refer to the Runtime Usage topic for more information about the various possible combinations of Runtime binding.

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 descriptive 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 may pass NULL for this parameter.
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.