MsiEnableLogA 함수(msi.h)

  • 아티클

MsiEnableLog 함수는 호출 프로세스에서 시작된 모든 후속 설치에 대한 로그 모드를 설정합니다.

구문

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR szLogFile,
  [in] DWORD  dwLogAttributes
);

매개 변수

[in] dwLogMode

로그 모드를 지정합니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값 의미
INSTALLLOGMODE_FATALEXIT
 메모리 부족 또는 심각한 종료 정보를 기록합니다.
INSTALLLOGMODE_ERROR
 오류 메시지를 기록합니다.
INSTALLLOGMODE_EXTRADEBUG
 핸들 생성 정보와 같은 추가 디버깅 정보를 로그 파일에 보냅니다.

Windows 2000 및 Windows XP: 이 기능은 지원되지 않습니다.
INSTALLLOGMODE_WARNING
 경고 메시지를 기록합니다.
INSTALLLOGMODE_USER
 사용자 요청을 기록합니다.
INSTALLLOGMODE_INFO
 표시되지 않는 상태 메시지를 기록합니다.
INSTALLLOGMODE_RESOLVESOURCE
 유효한 원본 위치를 확인하도록 요청합니다.
INSTALLLOGMODE_OUTOFDISKSPACE
 디스크 공간이 부족했음을 나타냅니다.
INSTALLLOGMODE_ACTIONSTART
 새 설치 작업의 시작을 기록합니다.
INSTALLLOGMODE_ACTIONDATA
 설치 작업을 사용하여 데이터 레코드를 기록합니다.
INSTALLLOGMODE_COMMONDATA
 사용자 인터페이스 초기화를 위한 매개 변수를 기록합니다.
INSTALLLOGMODE_PROPERTYDUMP
 종료 시 속성 값을 기록합니다.
INSTALLLOGMODE_VERBOSE
 INSTALLLOGMODE_EXTRADEBUG 제외한 다른 모든 로그 모드에서 정보를 기록합니다. 이렇게 하면 일반적으로 사용자에게 유용하지 않은 로그 파일에 많은 양의 정보가 전송됩니다. 기술 지원에 사용할 수 있습니다.
INSTALLLOGMODE_LOGONLYONERROR
 로깅 정보는 수집되지만 로그 파일에 덜 자주 저장됩니다. 이렇게 하면 일부 설치의 성능이 향상될 수 있지만 대규모 설치에 대한 이점은 거의 없습니다. 설치가 성공하면 로그 파일이 제거됩니다. 설치에 실패하면 모든 로깅 정보가 로그 파일에 저장됩니다.

Windows Installer 2.0: 이 로그 모드는 사용할 수 없습니다.

[in] szLogFile

로그 파일의 전체 경로를 포함하는 문자열을 지정합니다. null을 입력하면 로깅이 비활성화됩니다. 이 경우 dwlogmode 는 무시됩니다. 경로가 제공된 경우 dwlogmode 는 0이 아니어야 합니다.

[in] dwLogAttributes

로그 버퍼를 플러시할 빈도를 지정합니다.

값 의미
INSTALLLOGATTRIBUTES_APPEND
 이 값을 설정하면 설치 관리자가 szLogFile에 지정된 기존 로그를 추가합니다. 설정하지 않으면 szLogFile 으로 지정된 기존 로그를 덮어씁니다.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 각 줄 다음에 로그 버퍼를 강제로 플러시합니다. 이 값을 설정하지 않으면 설치 관리자는 FlushFileBuffers를 호출하여 20줄 후에 로그 버퍼를 플러시합니다.

반환 값

값 의미
ERROR_INVALID_PARAMETER
 잘못된 로그 모드가 지정되었습니다.
ERROR_SUCCESS
 함수가 성공했습니다.

설명

로깅 정책에 대한 설명은 시스템 정책을 참조하세요.

이 함수를 사용할 때 로그 파일 위치의 경로가 이미 있어야 합니다. 설치 관리자는 로그 파일에 대한 디렉터리 구조를 만들지 않습니다.

참고

msi.h 헤더는 MSiEnableLog를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows Server 2012, Windows 8, Windows Server 2008 R2 또는 Windows 7의 Windows Installer 5.0. Windows Server 2008 또는 Windows Vista의 Windows Installer 4.0 또는 Windows Installer 4.5. Windows Server 2003 또는 Windows XP의 Windows Installer. Windows Installer 버전에 필요한 최소 Windows 서비스 팩에 대한 자세한 내용은 Windows Installer 런타임 요구 사항을 참조하세요.
대상 플랫폼 Windows
헤더 msi.h
라이브러리 Msi.lib
DLL Msi.dll

추가 정보

인터페이스 및 로깅 함수

로깅