사용자 지정 작업에서 오류 메시지 반환

이 섹션에서는 동적 링크 라이브러리 또는 스크립트를 호출하여 설치의 일부를 실제로 수행하는 사용자 지정 작업에서 메시지를 보내는 방법을 설명합니다. 사용자 지정 작업 유형 19는 이 지정된 오류 메시지만 보내고 오류를 반환한 다음, 설치를 종료합니다. 사용자 지정 작업 유형 19는 설치의 어떤 부분도 수행하지 않습니다.

DLL(동적 연결 라이브러리)을 사용하는 사용자 지정 작업에서 오류 메시지를 보내려면 사용자 지정 작업이 MsiProcessMessage를 호출하도록 합니다. DoAction ControlEvent에서 시작한 사용자 지정 작업은 Message 메서드를 사용하여 메시지를 보낼 수 있지만 MsiProcessMessage를 사용하여 메시지를 보낼 수는 없습니다. Windows Server 2003 이전 시스템에서 DoAction ControlEvent에 의해 시작된 사용자 지정 작업은 MsiProcessMessage 또는 Message 메서드를 사용하여 메시지를 보낼 수 없습니다. 자세한 내용은 MsiProcessMessage를 사용하여 Windows Installer에 메시지 보내기를 참조하세요.

DLL을 사용하여 사용자 지정 작업 내에서 오류 메시지를 표시하려면 다음을 수행합니다.

  1. 사용자 지정 작업은 MsiProcessMessage를 호출하고 hInstall, eMessageTypehRecord 매개 변수를 전달해야 합니다. 설치에 대한 핸들인 사용자 지정 작업 유형 19사용자 지정 작업 내부에서 현재 설치 관리자 세션에 액세스 또는 MsiOpenProduct 또는 MsiOpenPackage에 설명된 대로 사용자 지정 작업에 제공될 수 있습니다.
  2. eMessageType 매개 변수는 MsiProcessMessage에 나열된 메시지 유형 중 하나를 지정해야 합니다.
  3. MsiProcessMessage 함수의 hRecord 매개 변수는 메시지 유형에 따라 달라집니다. MsiProcessMessage를 사용하여 Windows Installer에 메시지 보내기를 참조하세요. 메시지에 서식이 지정된 데이터가 포함된 경우 Formatted에 설명된 서식을 사용하여 Error 테이블에 메시지를 입력합니다.

스크립트를 사용하는 사용자 지정 작업에서 오류 메시지를 보내기 위해 사용자 지정 작업은 Session 개체의 Message 메서드를 호출할 수 있습니다.

스크립트를 사용하여 사용자 지정 작업 내에서 오류 메시지를 표시하려면 다음을 수행합니다.

  1. 사용자 지정 작업은 Session 개체의 Message 메서드를 호출하고 kindrecord 매개 변수를 전달해야 합니다.
  2. kind 매개 변수는 Message 메서드에 나열된 메시지 유형 중 하나를 지정해야 합니다.
  3. Message 메서드의 record 매개 변수는 메시지 유형에 따라 달라집니다. 메시지에 서식이 지정된 데이터가 포함된 경우 Formatted에 설명된 서식을 사용하여 Error 테이블에 메시지를 입력합니다.

실행 파일을 사용하는 사용자 지정 작업은 설치에 대한 핸들을 가져올 수 없으므로 MsiProcessMessage 또는 Message 메서드를 호출하여 메시지를 보낼 수 없습니다.

사용자 지정 작업 반환 값