다음을 통해 공유

MsiGetMode 함수(msiquery.h)

  • 아티클

MsiGetMode 함수는 테이블에 나열된 대로 설치 관리자가 현재 지정된 모드에서 실행 중인지 여부를 확인하는 데 사용됩니다. 함수는 함수에 전달된 특정 속성이 현재 설정(TRUE)인지 설정되지 않은지(FALSE) 나타내는 TRUE 또는 FALSE의 부울 값을 반환합니다.

구문

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

매개 변수

[in] hInstall

DLL 사용자 지정 작업에 제공되거나 MsiOpenPackage, MsiOpenPackageEx 또는 MsiOpenProduct를 통해 가져온 설치에 대한 핸들입니다.

[in] eRunMode

실행 모드를 지정합니다. 이 매개 변수에는 다음 값 중 하나가 있어야 합니다.

값 의미
MSIRUNMODE_ADMIN
 관리 모드가 설치되거나 제품이 설치되고 있습니다.
MSIRUNMODE_ADVERTISE
 보급 알림이 설치되거나 제품이 설치 또는 업데이트되고 있습니다.
MSIRUNMODE_MAINTENANCE
 기존 설치가 수정되거나 새 설치가 있습니다.
MSIRUNMODE_ROLLBACKENABLED
 롤백이 사용됩니다.
MSIRUNMODE_LOGENABLED
 로그 파일이 활성 상태입니다. 설치 세션 전에 사용하도록 설정되었습니다.
MSIRUNMODE_OPERATIONS
 실행 작업은 결정 단계에 있습니다.
MSIRUNMODE_REBOOTATEND
 성공적으로 설치한 후 다시 부팅해야 합니다(settable).
MSIRUNMODE_REBOOTNOW
 설치를 계속하려면 다시 부팅해야 합니다(settable).
MSIRUNMODE_CABINET
 캐비닛 및 미디어 테이블 파일의 파일이 설치됩니다.
MSIRUNMODE_SOURCESHORTNAMES
 원본 LongFileNames는 PID_MSISOURCE 요약 속성을 통해 표시되지 않습니다.
MSIRUNMODE_TARGETSHORTNAMES
 대상 LongFileNames는 SHORTFILENAMES 속성을 통해 표시되지 않습니다.
MSIRUNMODE_RESERVED11
 다음에 사용하도록 예약됩니다.
MSIRUNMODE_WINDOWS9X
 운영 체제는 9x 버전입니다.
MSIRUNMODE_ZAWENABLED
 운영 체제는 수요 설치를 지원합니다.
MSIRUNMODE_RESERVED14
 다음에 사용하도록 예약됩니다.
MSIRUNMODE_RESERVED15
 다음에 사용하도록 예약됩니다.
MSIRUNMODE_SCHEDULED
 설치 스크립트 실행에서 호출되는 사용자 지정 작업입니다.
MSIRUNMODE_ROLLBACK
 롤백 실행 스크립트에서 호출된 사용자 지정 작업입니다.
MSIRUNMODE_COMMIT
 커밋 실행 스크립트에서 호출된 사용자 지정 작업입니다.

반환 값

TRUE 는 함수에 전달된 특정 속성이 현재 설정되어 있음을 나타냅니다.

FALSE 는 함수에 전달된 특정 속성이 현재 설정되지 않음을 나타냅니다.

설명

지연된 사용자 지정 작업에서 MsiGetMode를 호출할 때 iRunMode의 모든 실행 모드 값을 사용할 수 있는 것은 아닙니다. 자세한 내용은 지연된 실행 사용자 지정 작업에 대한 컨텍스트 정보 가져오기를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 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
헤더 msiquery.h
라이브러리 Msi.lib
DLL Msi.dll

추가 정보

설치 관리자 상태 액세스 함수