概要情報ストリームの使用
このセクションでは、Windows インストーラー API のどの関数が概要情報ストリームのプロパティを呼び出せるかについて説明します。 概要情報ストリームと、それがデータベースでどのように動作するかの詳細については、「概要情報ストリームについて」を参照してください。
- インストーラーにはさまざまな種類のデータベースが含まれており、概要情報ストリームの一部のプロパティがデータベースごとに異なる意味を持っていることに注意することが重要です。 詳細については、「Summary プロパティの説明」を参照してください。
- データベースが別のデータベースの出力として開かれた場合、その出力データベースの概要情報ストリームは、実際には元のデータベースの読み取り専用のミラーであるため、変更できません。 さらに、データベースと共に永続化されることもありません。 出力データベースの概要情報を作成または変更するには、いったん閉じて、再び開く必要があります。
次の手順では、概要情報ストリーム関数を使用する方法について説明します。
概要情報ストリームのプロパティを使用するには
- MsiGetSummaryInformation 関数を呼び出して、概要情報ストリームを含むデータベースへのハンドルを取得します。
- MsiSummaryInfoGetPropertyCount 関数を呼び出して、既存のプロパティの数を取得します。
- MsiSummaryInfoGetProperty 関数を呼び出して、1 つの概要情報プロパティを表示します。
- MsiSummaryInfoSetProperty 関数を呼び出して、1 つのプロパティを設定します。
- MsiSummaryInfoPersist 関数を呼び出して、概要情報プロパティを保存します。
- MsiCreateTransformSummaryInfo 関数を呼び出して、既存の変換の概要情報を作成します。
Orca.exe と Msiinfo.exe は、データベースの概要情報ストリームを編集または表示するために使用できるツールです。 これらのツールは、Windows インストーラー開発者向けの Windows SDK コンポーネントからのみ入手できます。
概要情報ストリームにはまた、Windows インストーラーのオートメーション インターフェイスの次のメソッドとプロパティを使用してアクセスすることもできます。
- SummaryInfo.Property
- SummaryInfo.PropertyCount
- SummaryInfo.Persist
- Installer.SummaryInformation
- Database.SummaryInformation
- Database.CreateTransformSummaryInfo
Windows インストーラー開発者向けの Windows SDK コンポーネントには、VBScript ファイル WiSumInf.vbs が用意されています。 このサンプル スクリプトを使用すると、Windows インストーラー パッケージの概要情報ストリームを管理できます。 WiSumInf.vbs の詳細については、「概要情報の管理」を参照してください。