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 전달할 수 있습니다.

PMSIHANDLE 형식의 변수는 설치 관리자가 범위를 벗어날 때 PMSIHANDLE 개체를 닫기 때문에 사용하는 것이 좋습니다. 반면 msiCloseHandle호출하여 MSIHANDLE 개체를 닫아야 합니다. 자세한 내용은 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

참고 항목

요약 정보 속성 함수

요약 정보 스트림 속성 집합