VI를 메모리상에 놓고 VI에 대한 IDispatch 포인터를 반환합니다.

구문

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

파라미터

Name타입설명
viPath문자열메모리에 있는 VI의 절대 경로.
password문자열VI가 암호로 보호되어 있는 경우 편집을 하기 위해 반드시 암호를 입력해야 합니다.
resvForCall불리언

참인 경우 VI는 실행 예정된 실행 상태로 설정됩니다. 직상위 VI가 실행되고 있는 동안 VI는 언제든지 SubVI로 호출될 수 있기 때문에 실행 예정된 VI는 편집할 수 없습니다. VI를 실행 예정으로 설정하면 VI가 호출될 때 참조 속도가 빨라집니다. 그러나, 이 상태는 어떠한 편집 모드 프로퍼티 또는 메소드를 지원하지 않습니다. VI를 예약된 실행 상태에서 벗어나게 하려면, 이 참조를 닫고 다음을 설정하여 새 참조를 엽니다. resvForCall거짓으로 설정합니다.

재호출 VI로 동작하고 있다면 이 파라미터를 참으로 하여 LabVIEW가 효율적으로 VI를 호출할 수 있도록 설정합니다.

options부호없는 롱

VI 참조가 처리되는 방법을 지정하는 비트 세트. options다음 값의 조합이 될 수 있습니다. 기본은 0x11 입니다.

0x01수정사항을 기록합니다. VI 서버를 사용하여 변경이 이루어졌다는 것을 나타내기 위해서 VI 제목에 별표 (*)가 나타납니다. LabVIEW가 수정사항을 기록하려면 VI가 반드시 편집모드이어야 합니다.
0x02편집을 위해 템플릿을 엽니다. 이 옵션은 원본 .vit 파일을 엽니다. 이 옵션을 선택하지 않는 경우, LabVIEW는 템플릿 VI의 새 인스턴스를 엽니다. 인스턴스를 편집해도 원본 .vit 파일에는 영향을 미치지 않습니다. 이 옵션은 템플릿이 아닌 파일에 아무런 영향을 끼치지 않습니다.
0x04 다음 조건이 모두 참인 경우, 이 VI 참조가 닫힐 때 사용자에게 변경사항을 저장하도록 입력요청합니다:
  • 참조된 VI 또는 그 SubVI는 저장되지 않은 변경사항을 포함합니다.
  • 참조된 VI에 다른 열린 참조가 없습니다.
  • 참조된 VI는 메모리에서 제거될 수 있습니다. 예를 들면 어떤 다른 VI도 VI를 호출하지 않고, VI의 프런트패널이 닫혀져 있고, VI가 열린 프로젝트 라이브러리의 멤버가 아니거나 기타의 경우에 VI는 메모리에서 제거될 수 있습니다.
0x08재호출 실행을 준비합니다. 타겟 VI를 실행 예정 상태로 하여 편집되지 않도록 하며 타겟 VI가 재호출 VI인 경우, 이 VI 참조에 대한 전용 병렬 데이터 공간을 할당합니다. 타겟 VI가 재호출 VI가 아닌 경우, 이 메소드는 에러를 반환합니다. VI 참조를 해제할 때, LabVIEW는 재호출 타겟 VI를 보류하지 않으며 병렬 데이터 공간을 할당 해제합니다. 이 옵션을 실행 메소드와 함께 사용하여, 동시에 재호출 VI의 여러 인스턴스를 실행합니다. 재호출 VI를 타겟으로 하고 이 옵션을 사용하지 않는 경우, 이 메소드는 VI 참조에 병렬 데이터 공간을 할당하지 않고 VI의 참조를 반환합니다. 이 옵션을 사용하지 않을 때, 이 메소드에 대한 여러 재호출 VI 호출은 동일한 데이터 공간을 갖는 동일한 VI에게 참조를 반환하고, 이 메소드는 VI를 복제하지 않습니다.
0x10참조된 VI의 SubVI를 찾을 수 없는 경우 이를 사용자에게 검색하도록 입력 요청합니다.
0x20

참조된 VI의 SubVI를 찾을 수 없는 경우 이를 검색할 때 로딩 대화 상자를 디스플레이하지 않습니다.

노트 이 옵션을 사용하여 LabVIEW가 찾을 수 없는 VI를 사용자에게 검색하도록 입력 요청할지 여부를 결정할 수는 없습니다.

반환값

VirtualInstrument*