From 11:00 PM CST Friday, Apr 11th - 1:30 PM CST Saturday, Apr 12th, ni.com will undergo system upgrades that may result in temporary service interruption.

We appreciate your patience as we improve our online experience.

LabWindows/CVI

Content Type
Programming Language
Current manual
Table of Contents

SetDllExportOption

SetDllExportOption

LabWindows/CVI ActiveX Server Interface

CVI_AppSetDllExportOption (CAObjHandle objectHandle, ERRORINFO *errorInfo, enum CVIEnum_CVIDllExportOptions exportOption, 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

Specifies the method to use for determining which symbols in the DLL to export to DLL users.

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.
exportOption enum CVIEnum_CVIDllExportOptions Specifies the export option to use. You can specify one of the following constants:

  • CVI_DLL_EXPORT_SYMBOLS_AS_MARKED (0)—The DLL exports all symbols you define in the DLL with the __declspec (dllexport) or export qualifier.
  • CVI_DLL_EXPORT_INCLUDE_FILE_SYMBOLS (1)—You must name one or more include files that declare symbols defined globally in the DLL. The DLL exports the symbols you declare in the include files.
  • CVI_DLL_EXPORT_INCLUDED_AND_MARKED_SYMBOLS (2)—The DLL exports all symbols you define in the DLL with the __declspec (dllexport) or export qualifier and the symbols you declare in the include files.
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.
Was this information helpful?

Help us improve your future ni.com experience.

What are you trying to do?

Submit