Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

Characteristics of LabVIEW-Built Shared Libraries

LabVIEW 2013 Help

Edition Date: June 2013

Part Number: 371361K-01

»View Product Info

LVDLLStatus Function

All DLLs built from LabVIEW, in addition to the functions you export, contain an exported function called LVDLLStatus, with the following prototype:

MgErr LVDLLStatus(CStr errStr, int32 errStrLen, void *module)

The calling program uses this function to verify that the LabVIEW DLL loaded correctly. If an error occurs while loading the DLL, the function returns the error. Pass a string buffer to the errStr parameter to receive additional information about the error. Set the errStrLen parameter to the number of bytes in the string buffer passed as errStr. You can use the module parameter to retrieve the handle to the LabVIEW Run-Time Engine being used by the DLL. Typically, you can leave this parameter as NULL.

Note  If you call a LabVIEW-built DLL from within LabVIEW, LabVIEW automatically calls the LVDLLStatus function for you.
(Mac OS X) To build part of a shared library in LabVIEW, Application Builder must use gcc, the standard command-line compiler for Unix and MAC OS X operating systems. Use Xcode, the standard development environment for Apple computers, to install gcc. You can download Xcode for free from the Mac App Store.

Memory Allocation

To manage memory allocation for LabVIEW array types exposed as handles, the LabVIEW-built shared library provides Allocate, Deallocate, and Resize functions for each array type exposed as a handle. Open the generated header file to view the function prototypes specific to the generated shared library.


 Was this document helpful?  submit
  Helpful Not Helpful