在内存中加载VI并返回VI的IDispatch指针。

语法

object.GetVIReference(viPath, [password], [resvForCall], [options])

参数

名称类型说明信息
viPath字符串内存中VI的绝对路径。
password字符串如VI已被密码保护，必须输入密码才可进行改动。
resvForCall布尔

如值为TRUE，则VI的执行状态将设置为保留。用户无法编辑保留的VI，因为当该VI的父VI运行时，该VI随时可能被作为子VI调用。引用时将VI设置为保留可加快调用VI的速度。但是，这种执行状态下不支持任何编辑模式的属性或方法。如需使VI退出保留执行状态，可关闭该引用并通过设置 resvForCall 为假。

处理重入VI时，应将该参数设置为TRUE，以便LabVIEW高效调用该VI。

options无符号长整型

设置VI引用的方式。 options 可以是下列值的组合。默认值为0x10。

0x01记录修改。VI标题旁的星号(*)表示VI服务器已对VI进行修改。只有在编辑模式下，LabVIEW才能记录修改。
0x02打开模板进行编辑。选择该选项将打开原有的.vit文件。如不选择该选项，LabVIEW将打开该模板VI的新实例。对实例的编辑不影响原有的.vit文件。该选项不会影响非模板文件。
0x04 如下列所有条件为真，当该VI引用关闭时，提示用户保存更改：
  • 引用指向的VI或其子VI包含未保存的更改。
  • 该VI没有其它打开的引用。
  • 引用指向的VI可以从内存中释放。VI在下列情况下可从内存中释放：无其它VI调用该VI；VI的前面板已关闭；VI不属于打开的项目库等。
0x08准备重入运行。将终端VI设置为保留，使其无法被编辑，如终端VI为可重入，则为该VI引用分配固定的并行数据空间。如终端VI为非重入，该方法将返回错误。释放VI引用时，LabVIEW不再保留可重入的终端VI，并将释放并行数据空间。将该选项和运行方法结合可同时运行重入VI的多个实例。如终端为重入VI并且未使用该选项，该方法将返回对VI的引用而不为其分配并行数据空间。不使用该选项时，为重入VI多次调用该方法将在相同的数据空间中返回对同一个VI的引用，该方法将不创建VI的副本。
0x10提示用户查找引用VI中缺失的子VI。
0x20

引用所指的VI的子VI发生缺失时，不显示查找对话框。

注： 该选项不影响LabVIEW提示用户查找缺失的VI。

返回值

VirtualInstrument*