UiCreatePatchPackageEx(Patchwiz.dll)

UiCreatePatchPackageEx 함수는 패키지 만들기 파일(.pcp 파일)을 가져와 Windows Installer 패치 패키지(.msp 패키지)를 생성합니다. Msimsp.exe를 호출하는 것은 Patchwiz.dll을 사용하는 데 권장되는 방법입니다.

UiCreatePatchPackageEx 함수는 Patchwiz.dll 버전 4.0부터 사용할 수 있으며 UiCreatePatchPackage 함수의 기능을 확장합니다.

UINT UiCreatePatchPackageEx(
  LPCTSTR szPcpPath,              
  LPCTSTR szPatchPath,            
  LPCTSTR szLogPath,             
  HWND hwndStatus,                
  LPCTSTR szTempFolder,           
  BOOL fRemoveTempFolderContents,
  DWORD dwFlags,
  DWORD dwReserved    
);

매개 변수

szPcpPath

이 패치에 대한 패치 만들기 속성 파일(.pcp 파일)의 전체 경로입니다.

szPatchPath

만들어질 Windows Installer 패치 패키지(.msp 파일)의 전체 경로입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 있지만 생략될 수는 없습니다. 이 매개 변수가 NULL 또는 빈 문자열인 경우 함수는 Property 테이블(Patchwiz.dll)에서 PatchOutputPath의 값을 사용합니다.

szLogPath

추가될 텍스트 로그 파일의 전체 경로입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 있지만 생략될 수는 없습니다.

hwndStatus

상태 텍스트를 표시하는 창에 대한 핸들입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 있지만 생략될 수는 없습니다.

szTempFolder

임시 파일의 위치입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 있지만 생략될 수는 없습니다. 사용자는 이 폴더를 읽고 쓸 수 있는 충분한 권한이 있어야 합니다. 기본 위치는 %TMP%\~pcw_tmp.tmp\입니다.

fRemoveTempFolderContents

TRUE이면 임시 폴더와 모든 해당 콘텐츠(있는 경우)를 제거합니다. FALSE 및 폴더가 있으면 함수가 실패합니다.

dwFlags

이 매개 변수는 로깅 또는 사용자 인터페이스 옵션을 지정하기 위해 다음 값 중 하나 또는 조합으로 설정할 수 있습니다.

플래그	값	의미
LOGNONE	0x00000000	로그에 메시지를 쓰지 않습니다.
LOGINFO	0x00000001	로그에 정보 메시지를 씁니다.
LOGWARN	0x00000002	로그에 경고를 씁니다.
LOGERR	0x00000004	로그에 오류 메시지를 씁니다.
LOGPERFMESSAGES	0x00000008	로그에 성능 메시지를 씁니다.
UINONE	0x00000000f	사용자 인터페이스를 표시하지 마세요.
UIALL	0x00000010	사용자 인터페이스를 표시합니다.

 

dwReserved

예약되어 있습니다. 이 매개 변수는 0으로 설정해야 합니다.

반환 값

UiCreatePatchPackage에 대한 반환 값의 표를 참조하세요.

설명

.pcp 파일을 작성하고 UiCreatePatchPackage를 사용하여 Windows Installer 패치 패키지를 생성하는 예제는 작은 업데이트 패치 예제 섹션을 참조하세요.

패치를 만들려면 압축되지 않은 설치 이미지(예: CD-ROM의 관리 이미지 또는 압축되지 않은 설치 이미지)가 필요합니다. UiCreatePatchPackage는 캐비닛의 파일에 대해 이진 패치를 생성하지 않습니다.