Properties 테이블(Patchwiz.dll)

아티클
06/13/2023

Properties 테이블에는 패치 패키지에 대한 전역 설정이 포함되어 있습니다. Properties 테이블은 패치 만들기 데이터베이스(.pcp 파일)에서 필수이며 UiCreatePatchPackageEx 함수에서 사용됩니다.

Properties 테이블에는 다음과 같은 열이 있습니다.

Column	형식	키	Nullable
속성	text	Y	N
값	text		Y

열

Name: 패치 만들기 속성의 이름입니다.
Value: 패치 만들기 속성의 값입니다.

설명

다음 표에서는 .pcp 파일의 Properties 테이블에 입력할 수 있는 패치 만들기 속성 문자열을 식별합니다.

속성	설명
AllowLaxValidationFlags	이 속성을 1로 설정하면 항목이 로그에 기록되고 TargetImages 테이블의 ProductValidateFlags 필드의 유효성을 검사할 수 없는 경우 오류가 반환되지 않습니다. 이 속성은 패치 작성자가 ProductValidateFlags 필드의 값을 변경한 경우에만 설정해야 합니다. 이 속성의 기본값은 0입니다. Patchwiz.dll 버전 4.0부터 사용할 수 있습니다.
AllowProductCodeMismatches	ProductCode 속성이 UpgradedImages 테이블에 나열된 업그레이드된 이미지와 TargetImages 테이블에 나열된 대상 이미지 간에 다를 수 있는 경우 True에 대해 ‘1’로 설정합니다. 제품 코드가 동일해야 하는 경우 False를 의미하려면 ‘0’ 또는 공백으로 설정합니다.
AllowProductVersionMajorMismatches	ProductVersion 속성의 첫 번째 필드(주 버전 필드)가 업그레이드된 이미지와 대상 이미지 간에 다를 수 있는 경우 True를 의미하려면 ‘1’로 설정합니다. 주 버전이 일치해야 하는 경우 False를 의미하려면 ‘0’ 또는 공백으로 설정합니다.
ApiPatchingSymbolFlags	이진 파일 패치를 만들 때 사용할 패치 기호 사용 플래그의 조합을 나타내는 8자리 16진수 정수입니다. 기본값은 0x00000000입니다. 가능한 PATCH_SYMBOL_* 플래그의 전체 목록은 Patchapi.h를 참조하세요. 기호 파일에 대한 자세한 내용은 용어집을 참조하세요.
DontRemoveTempFolderWhenFinished	변환, 바이트 수준 패치 및 전체 새 파일이 포함된 임시 폴더가 패치 패키지를 만든 후 제거되지 않는 경우 True를 의미하려면 ‘1’로 설정합니다. 이는 기본적으로 패치 패키지에 포함되기 전에 .msp 파일의 내용입니다. 이는 패치를 디버깅하는 데 유용할 수 있습니다. 임시 폴더를 제거할 경우 False를 의미하려면 ‘0’ 또는 공백으로 설정합니다.
IncludeWholeFilesOnly	변경 중인 파일이 이진 파일 패치를 만드는 대신 패치 패키지를 만들 때 전체가 포함되어야 하는 경우, True를 의미하려면 ‘1’로 설정합니다. 패치 파일의 크기는 더 크지만 API는 더 빠르게 실행됩니다. 이진 파일 패치를 만드는 경우 False를 의미하려면 ‘0’으로 설정하거나 공백으로 설정합니다.
ListOfPatchGUIDsToReplace	구분 기호가 없는 PatchGUID 식별자 목록입니다. 이러한 패치가 사용자의 컴퓨터에 설치되어 있고 Windows Installer에 등록된 것으로 확인되면 해당 제품의 등록이 취소되고 해당 패치 변환이 제품과 연결된 변환 목록에서 제거됩니다. 패치를 제거해도 파일에는 영향을 주지 않고 패치 등록에만 영향을 미칩니다. (선택 사항)
ListOfTargetProductCodes	이 패치를 받을 수 있는 제품에 대한 제품 코드 목록입니다. ProductCode 속성 값의 세미콜론으로 구분된 목록입니다. 목록이 별표로 시작하는 경우 TargetImages 테이블에 나열된 대상의 .msi 파일에서 제품 코드 목록이 생성됩니다. 선행 별표 뒤에 어떤 제품 코드가 나오면 별표를 대체하는 목록에 추가됩니다. 속성이 설정되지 않는 경우 TargetImages 테이블에 나열된 대상의 .msi 파일에서 제품 코드 목록이 생성됩니다.
MsiFileToUseToCreatePatchTables	Patch 테이블 및 PatchPackage 테이블을 내보낼 템플릿 .msi 파일의 전체 경로입니다. Optional.The Properties 테이블에서는 환경 변수를 Patchwiz.dll 버전 4.0부터 시작하는 경로로 허용합니다. %ENV_VAR%와 같은 환경 변수에 Windows 형식을 사용합니다. 형식 있음 열 데이터 유형을 사용하지 마세요.
OptimizePatchSizeForLargeFiles	이 속성은 값이 있고 “0”이 아닌 경우 설정됩니다. 이 속성을 설정하면 크기가 약 4MB보다 큰 파일에 대한 패치를 더 작게 만들 수 있습니다.
PatchGUID	이 패치 패키지(.msp 파일)에 대한 GUID 식별자입니다. 모든 패치 패키지에는 고유한 PatchGUID 값이 있어야 합니다. 필수 요소.
PatchOutputPath	생성할 패치 패키지 파일의 전체 경로(파일 이름 포함)입니다. szPatchPath가 UiCreatePatchPackageEx 함수에 의해 전달되면 전달된 값이 사용됩니다. szPatchPath가 null이거나 빈 문자열인 경우 이 속성이 필요합니다. Properties 테이블은 Patchwiz.dll 버전 4.0부터 시작하는 경로에 대한 환경 변수를 허용합니다. %ENV_VAR%와 같은 환경 변수에 Windows 형식을 사용합니다. 형식 있음 열 데이터 유형을 사용하지 마세요.
PatchSourceList	로컬로 캐시된 복사본을 사용할 수 없는 경우 패치에 대한 .msp 파일을 찾는 데 사용되는 원본입니다. 이 값은 제품에 적용될 때 패치의 원본 목록에 추가됩니다. (선택 사항)
MinimumRequiredMsiVersion	Patchwiz.dll이 특정 버전의 Windows Installer를 요구하는 패치를 강제로 생성하도록 이 속성을 설정합니다. 이 속성 값은 패치 패키지의 워드 수 요약 속성에 사용할 값을 결정하는 데 도움이 됩니다. 이 속성의 값은 설치 패키지의 페이지 수 요약 속성과 같은 형식입니다. .pcp 파일에서 MinimumRequiredMsiVersion이 200과 같으면 Patchwiz.dll은 패치 패키지의 단어 수 요약 속성을 3으로 설정합니다. 이렇게 하면 2.0 이전 버전의 Windows Installer 버전에서 패치를 적용할 수 없습니다. .pcp 파일에서 MinimumRequiredMsiVersion이 300과 같으면 Patchwiz.dll은 패치 패키지의 단어 수 요약 속성을 4로 설정합니다. 이렇게 하면 3.0 이전 버전의 Windows Installer 버전에서 패치를 적용할 수 없습니다. .pcp 파일에서 MinimumRequiredMsiVersion이 310과 같으면 Patchwiz.dll은 패치 패키지의 단어 수 요약 속성을 5로 설정합니다. 이렇게 하면 3.1 이전 버전의 Windows Installer 버전에서 패치를 적용할 수 없습니다. .pcp 파일에서 MinimumRequiredMsiVersion이 400과 같으면 Patchwiz.dll은 패치 패키지의 단어 수 요약 속성을 6으로 설정합니다. 이렇게 하면 4.0 이전 버전의 Windows Installer 버전에서 패치를 적용할 수 없습니다.
PATCH_CACHE_ENABLED	이 속성을 1로 설정하여 PATCH_CACHE_DIR 속성에 의해 지정된 폴더에 패치 만들기 정보를 캐시합니다. 패치 캐싱은 업데이트 이미지를 업데이트한 후 새 패치를 다시 만들 때 패치 만들기 속도를 높입니다. 이 속성을 사용하려면 Windows Installer 2.0 이상에서 Patchwiz.dll이 필요합니다. 자세한 내용은 패치 정보 캐싱(Patchwiz.dll)을 참조하세요.
PATCH_CACHE_DIR	이 속성을 캐시된 패치 정보를 저장하는 폴더의 이름으로 설정합니다. 필요한 경우 Patchwiz.dll이 이 폴더를 만듭니다. 폴더는 디스크 공간이 충분한 드라이브에 있어야 합니다. 이 속성 PATCH_CACHE_ENABLED 속성이 1로 설정된 경우에만 사용됩니다. 속성 테이블은 Patchwiz.dll의 버전 4.0부터 시작하는 경로에 대한 환경 변수를 허용합니다. %ENV_VAR%와 같은 환경 변수에 Windows 형식을 사용합니다. 형식 있음 열 데이터 유형을 사용하지 마세요.
SEQUENCE_DATA_GENERATION_DISABLED	패치 시퀀싱 정보의 자동 생성을 방지하려면 이 속성을 1(일)로 설정합니다. 이 속성이 없으면 시퀀싱 정보가 자동으로 생성되어 추가됩니다.
SEQUENCE_DATA_SUPERSEDENCE	이 속성을 0(제로) 또는 1(일)로 설정하여 MsiPatchSequence 테이블에 있는 모든 행의 특성 필드에 해당 값을 작성합니다.
TrustMsi	속성 테이블에서 이 속성을 1로 설정하여 .msi 파일에 제공된 파일 버전 정보, 크기 및 해시 값을 사용합니다. 이 속성을 설정했지만 .msi 파일의 정보가 올바르지 않으면 생성된 패치가 제대로 작동하지 않을 수 있습니다. MsiFiler.exe를 사용하여 대상 및 업그레이드된 .msi 파일을 업데이트해야 합니다. 이 속성의 기본값은 0입니다. Patchwiz.dll 버전 4.0부터 사용할 수 있습니다.