MsiGetSummaryInformationA 함수(msiquery.h)

MsiGetSummaryInformation 함수는 설치 관리자 데이터베이스에 대한 _SummaryInformation 스트림에 대한 핸들을 가져옵니다. 이 함수는 MsiCloseHandle을 사용하여 닫아야 하는 핸들을 반환합니다.

구문

UINT MsiGetSummaryInformationA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szDatabasePath,
  [in]  UINT      uiUpdateCount,
  [out] MSIHANDLE *phSummaryInfo
);

매개 변수

[in] hDatabase

데이터베이스에 대한 핸들입니다.

[in] szDatabasePath

데이터베이스의 경로를 지정합니다.

[in] uiUpdateCount

업데이트된 값의 최대 수를 지정합니다.

[out] phSummaryInfo

요약 정보 핸들을 받을 위치에 대한 포인터입니다.

반환 값

MsiGetSummaryInformation 함수는 다음 값을 반환합니다.

설명

MsiGetSummaryInformation 함수에서 지정한 데이터베이스가 열려 있지 않으면 hDatabase에 대해 0을 지정하고 szDatabasePath에서 데이터베이스 경로를 지정해야 합니다. 데이터베이스가 열려 있는 경우 szDatabasePath 를 0으로 설정해야 합니다.

0보다 큰 uiUpdateCount 값을 사용하여 기존 요약 정보 스트림을 여는 경우 phSummaryInfo 핸들을 닫기 전에 MsiSummaryInfoPersist를 호출해야 합니다. 이렇게 하지 않으면 기존 스트림 정보가 손실됩니다.

MsiGetSummaryInformation을 사용하여 패치의 요약 정보를 보려면 szDatabasePath를 패치 경로로 설정합니다. 또는 MsiOpenDatabase를 사용하여 패치에 대한 핸들을 만든 다음, 해당 핸들을 hDatabase 매개 변수로 MsiGetSummaryInformation에 전달할 수 있습니다.

설치 관리자가 SCOPE 나가는 동안 PMSIHANDLE 개체를 닫고 MsiCloseHandle을 호출하여 MSIHANDLE 개체를 닫아야 하므로 PMSIHANDLE 형식의 변수를 사용하는 것이 좋습니다. 자세한 내용은 Windows Installer 모범 사례의 HANDLE 대신 PMSIHANDLE 사용 섹션을 참조하세요.

함수가 실패하면 MsiGetLastErrorRecord를 사용하여 확장된 오류 정보를 얻을 수 있습니다.

참고

msiquery.h 헤더는 MSiGetSummaryInformation을 유니코드 전처리기 상수의 정의에 따라 이 함수의 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
헤더	msiquery.h
라이브러리	Msi.lib
DLL	Msi.dll

추가 정보

요약 정보 속성 함수

요약 정보 스트림 속성 집합