Lädt ein VI in den Speicher und gibt den Zeiger "IDispatch" für das VI aus.

Syntax

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

Parameter

NameTypBeschreibung
viPathStringAbsoluter Pfad zum VI, das in den Speicher geladen wurde.
passwordStringWenn das VI durch ein Passwort geschützt ist, müssen Sie dieses eingeben, um das VI bearbeiten zu können.
resvForCallBoolesch

Bei TRUE wird das VI auf den Ausführungszustand "Reserviert" gesetzt. Sie können ein solches VI nicht bearbeiten, da es jederzeit als SubVI aufgerufen werden kann, wenn das Eltern-VI läuft. Wenn der Reservierungsmodus für das VI zum Zeitpunkt der Referenz aktiviert wird, werden Aufrufe des VIs beschleunigt. In diesem Zustand werden allerdings keine Eigenschaften oder Methoden des Bearbeitungsmodus unterstützt. Um den Ausführungszustand "reserviert" für das VI aufzuheben, schließen Sie die Referenz und öffnen Sie eine neue Referenz durch Einstellung resvForCall auf FALSE.

Bei ablaufinvarianten VIs setzen Sie den Parameter auf TRUE, damit LabVIEW das VI ohne Leistungseinbußen aufrufen kann.

optionsunsigned long

Bitmuster, das angibt, wie die VI-Referenz behandelt wird. options kann eine Kombination der folgenden Werte sein Der Standardwert lautet 0x10.

0x01Änderungen aufzeichnen. Ein Sternchen (*) neben dem VI-Titel zeigt an, dass das VI durch den VI-Server verändert wurde. Damit LabVIEW die Veränderung aufzeichnet, muss sich das VI im Bearbeitungsmodus befinden.
0x02Vorlagen zur Bearbeitung öffnen. Mit dieser Option wird die ursprüngliche *.vit-Datei geöffnet. Wenn Sie diese Option nicht auswählen, öffnet LabVIEW eine neue Kopie der VI-Vorlage. Die ursprüngliche *.vit-Datei ist von Änderungen an einem einzelnen Exemplar nicht betroffen. Auf Dateien, die keine Vorlagen sind, hat diese Option keinen Einfluss.
0x04 Wenn diese VI-Referenz geschlossen wird und alle folgenden Bedingungen wahr sind, sollte der Benutzer zum Speichern von Änderungen aufgefordert werden:
  • Das VI, auf das verwiesen wird, oder eines seiner SubVIs enthält ungespeicherte Änderungen.
  • Es bestehen keine weiteren offenen Referenzen auf das angegebene VI.
  • Das VI, auf das verwiesen wird, kann aus dem Speicher entfernt werden. Ein VI kann immer dann aus dem Speicher entfernt werden, wenn es zum Beispiel von keinem anderen VI aufgerufen wird, das Frontpanel des VIs geschlossen wird oder das VI zu keiner geöffneten Projektbibliothek gehört.
0x08Ablaufinvariante Ausführung vorbereiten. Reserviert das VI, so dass es nicht bearbeitet werden kann. Ist das VI ablaufinvariant, dann wird dieser VI-Referenz ein speziell reservierter Datenraum im Speicher zugewiesen. Bei einem nicht ablaufinvarianten VI gibt die Methode einen Fehler aus. Wenn Sie die VI-Referenz schließen, wird die Reservierung des ablaufinvarianten VIs aufgehoben und der reservierte Speicherplatz freigegeben. Diese Option erlaubt Ihnen, mit der Methode Ausführen mehrere Instanzen eines ablaufinvarianten VIs gleichzeitig auszuführen. Wenn Sie mit einem ablaufinvarianten VI arbeiten und diese Option nicht nutzen, gibt diese Methode eine Referenz auf das VI aus, aber reserviert für die VI-Referenz keinen Speicherplatz. Sollten Sie auf diese Option verzichten, werden bei mehrfachen Aufrufen dieser Methode für ein ablaufinvariantes VI Referenzen auf dasselbe VI mit demselben Datenraum im Speicher ausgegeben und das VI wird nicht kopiert.
0x10Benutzer zur Angabe fehlender SubVIs des angegebenen VIs auffordern.
0x20

Während der Suche nach fehlenden SubVIs des angegebenen VIs kein Ladedialogfeld anzeigen.

Hinweis Diese Option wirkt sich nicht auf die Eingabeaufforderung zur Suche nach fehlenden VIs aus.

Ausgabewert

VirtualInstrument*