다음을 통해 공유

WriteEnvironmentStrings 작업

  • 아티클

WriteEnvironmentStrings 작업은 환경 변수의 값을 수정합니다.

WriteEnvironmentStrings 작업 또는 RemoveEnvironmentStrings 작업이 실행되면 설치 진행 중인 환경 변수는 변경되지 않습니다. Windows 2000, Windows Server 2003, Windows XP 및 Windows Vista에서는 이 정보는 레지스트리에 저장되며 설치가 완료되면 변경 내용을 시스템에 알리기 위해 WM_SETTINGCHANGE 메시지가 전송됩니다. 다른 프로세스는 해당 메시지를 처리하여 변경 내용에 대한 알림을 받을 수 있습니다. 시스템 다시 시작이 보류 중인 경우 메시지가 전송되지 않습니다. 패키지는 MsiSystemRebootPending 속성을 사용하여 시스템 다시 시작이 보류 중인지 여부를 확인할 수 있습니다.

설치 관리자는 구성 요소를 설치하거나 다시 설치하는 동안에만 WriteEnvironmentStrings 작업을 실행하고 구성 요소를 제거하는 동안에만 RemoveEnvironmentStrings 작업을 실행합니다.

값은 기본 작업 및 한정자의 선택에 따라 작성되거나 제거됩니다. 다음 ActionData 메시지 섹션에서 설명합니다. 지정된 작업에 따라 WriteEnvironmentStrings는 변수를 제거할 수 있으며, RemoveEnvironmentStrings는 환경 테이블의 작성에 따라 변수를 추가할 수 있습니다.

시퀀스 제한

InstallValidate 작업은 RemoveEnvironmentStrings 작업 전에 실행해야 합니다. WriteEnvironmentStrings 작업 및 RemoveEnvironmentStrings 작업은 구성 요소를 설치하거나 제거하는 동안 적용되지 않으므로 상대 시퀀스가 제한되지 않습니다.

ActionData 메시지

필드 작업 데이터에 대한 설명
 [1] 수정할 환경 변수의 이름입니다.
[2] 환경 변수 값입니다.
[3] 수행할 작업을 지정하는 비트 플래그 필드입니다. 기본 작업에 대해 한 비트만 포함합니다. 이 필드에 포함된 한정자 비트가 둘 이상 있을 수 있습니다. 다음 비트 플래그 설명을 참조하세요.

 

비트 값 기본 작업에 대한 설명
0x1 설정. 모든 경우에 환경 변수의 값을 설정합니다.
이 비트가 추가 또는 접두사 한정자 비트와 결합한 경우 작업은 변수의 기존 값에 값을 추가합니다.
0x2 설정. 변수가 없는 경우 값을 설정합니다.
이 비트가 추가 또는 접두사 한정자 비트와 결합한 경우 작업은 변수의 기존 값에 값을 추가합니다.
0x4 제거 변수에서 값을 제거합니다.
이 비트가 추가 또는 접두사 한정자 비트와 결합한 경우 값이 있는 경우 기존 문자열에서 값이 제거됩니다.

 

비트 값 한정자에 대한 설명
0x20000000 이 비트가 설정되면 작업이 컴퓨터 환경 변수에 적용됩니다.
이 비트를 설정하지 않으면 작업이 사용자의 환경 변수에 적용됩니다.
0x40000000 Append. 이 비트는 선택 사항입니다. 추가 및 접두사 한정자를 모두 설정하지 마세요.
0x80000000 접두사입니다. 이 비트는 선택 사항입니다. 추가 및 접두사 한정자를 모두 설정하지 마세요.