Installer オブジェクト
COM がインストーラー機能にアクセスするために必要な自動化のサポートを読み込むには、最初に Installer オブジェクトを作成する必要があります。 このオブジェクトでは、最上位レベルのオブジェクトを作成し、そのメソッドにアクセスするためのラッパーが提供されます。
Installer オブジェクトは、ProgId "WindowsInstaller.Installer" から作成できます。
メンバー
Installer オブジェクトには次の種類のメンバーがあります。
メソッド
Installer オブジェクトには次のメソッドがあります。
| 方法 | 説明 |
|---|---|
| AddSource | sourcecelist の有効なネットワーク ソースの一覧にソースを追加します。 |
| AdvertiseProduct | インストール パッケージをアドバタイズします。 |
| AdvertiseScript | インストール パッケージをアドバタイズします。 |
| ApplyMultiplePatches | パッチの受信対象となる製品に 1 つ以上のパッチを適用します。
PATCH プロパティを、提供されたパッチ パッケージのパスに設定します。 |
| ApplyPatch | インストールを呼び出し、パッチ パッケージによってパッチの受信対象として登録されている各製品について、パッチ パッケージのパスに PATCH プロパティを設定します。 |
| ClearSourceList | sourcelist からすべてのネットワーク ソースを削除します。 |
| CollectUserInfo | ユーザー情報と製品コードの両方を収集し、格納するユーザー インターフェイス ウィザード シーケンスを呼び出します。 |
| ConfigureFeature | 製品機能のインストール済み状態を構成します。 |
| ConfigureProduct | 製品をインストールまたはアンインストールします。 |
| CreateAdvertiseScript | アドバタイズ スクリプトを生成します。 |
| CreateRecord | 要求されたフィールド数を含む新しい Record オブジェクトを返します。 |
| EnableLog | 現在のプロセス空間における後続のすべてのインストール セッションに対して、選んだメッセージの種類のログを有効にします。 |
| ExtractPatchXMLData | パッチから XML 文字列として情報を抽出します。 |
| FileHash | ファイルへのパスを取得し、そのファイルの 128 ビット ハッシュを返します。 |
| FileSignatureInfo | ファイルのパスを受け取り、ハッシュまたはエンコードされた証明書を表すバイトの SAFEARRAY を返します。 |
| FileSize | 指定したファイルのサイズを返します。 |
| FileVersion | 指定したパスのバージョン文字列または言語文字列を返します。 |
| ForceSourceListResolution | 次にソースが必要になったときに、有効な製品ソースをソース一覧から検索するようにインストーラーに強制します。 |
| InstallProduct | インストーラー パッケージを開き、インストール セッションを初期化します。 |
| LastErrorRecord |
Record オブジェクトを返します。これには、エラー レコードを生成した関数からの最新のエラーに対するエラー パラメーターが含まれています。 |
| OpenDatabase | 既存のデータベースを開くか、新規に作成します。 |
| OpenPackage | 製品データベースとインストール エンジンにアクセスする関数で使うためにインストーラー パッケージを開きます。 |
| OpenProduct | 製品コードを使ってインストールされた製品のインストーラー パッケージを開きます。 |
| ProvideAssembly | アセンブリのインストールされたパスを返します。 |
| ProvideComponent | コンポーネントの完全なパスを返し、必要なインストールを実行します。 |
| ProvideQualifiedComponent | コンポーネントの完全なパスを返し、必要なインストールを実行します。 |
| RegistryValue | 指定したレジストリ キーの値に関する情報を読み取ります。 |
| ReinstallFeature | 機能を再インストールするか、インストールされた機能に関する問題を修正します。 |
| ReinstallProduct | 製品を再インストールするか、インストールされた製品のインストールに関する問題を修正します。 |
| RemovePatches | パッチの受信対象となる製品に対する 1 つ以上のパッチを削除します。 |
| UseFeature | 特定の機能の使用カウントをインクリメントし、その機能のインストール状態を返します。 |
プロパティ
Installer オブジェクトには次のプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
ClientsEx |
指定したインストール済みコンポーネントを使う製品を列挙する RecordList オブジェクトを返します。 Windows インストーラー 4.5 以前: サポートされていません。 |
|
|
ComponentClients |
指定したコンポーネントの一連のクライアントを列挙する StringList オブジェクトを返します。 |
|
|
ComponentPath |
インストールされているコンポーネントの完全なパスを返します。 |
|
|
ComponentPathEx |
指定したインストール済みコンポーネントの完全なパスを示す RecordList オブジェクトを返します。 Windows インストーラー 4.5 以前: サポートされていません。 |
|
|
ComponentQualifiers |
指定したコンポーネントの登録されている一連の修飾子を列挙する StringList オブジェクトを返します。 |
|
|
Components |
すべての製品にインストールされている一連のコンポーネントを列挙する StringList オブジェクトを返します。 |
|
|
ComponentsEx |
インストールされているコンポーネントを列挙する RecordList オブジェクトを返します。 Windows インストーラー 4.5 以前: サポートされていません。 |
|
|
環境 |
読み取り/書き込み |
現在のプロセスの環境変数に対する文字列値。 |
|
FeatureParent |
機能の親機能を指定します。 |
|
|
機能 |
指定した製品の一連の公開された機能を列挙する StringList オブジェクトを返します。 |
|
|
FeatureState |
機能のインストール済み状態を返します。 |
|
|
FeatureUsageCount |
機能が使われた回数を返します。 |
|
|
FeatureUsageDate |
指定した機能が最後に使われた日付を返します。 |
|
|
FileAttributes |
ファイルまたはフォルダーの指定したパスについて、結合したファイル属性を表す数値を返します。 |
|
|
修正プログラム |
製品に適用されたすべてのパッチを含む StringList オブジェクトを返します。 |
|
|
PatchesEx |
Patch オブジェクトのコレクションを列挙します。 |
|
|
PatchFiles |
指定したパッチの一覧で更新できるファイルの一覧を含む StringList オブジェクトを返します。 |
|
|
PatchInfo |
パッチに関する情報を返します。 |
|
|
PatchTransforms |
指定したパッチ パッケージに含まれ、指定した製品に適用される変換のセミコロン区切りの一覧を返します。 |
|
|
ProductElevated |
製品が管理されている場合は True、製品が管理されていない場合は False を返します。 |
|
|
ProductInfo |
インストールまたは公開された製品について、指定した属性の値を返します。 |
|
|
ProductInfoFromScript |
アドバタイズ スクリプトに格納されている、指定した属性の値を返します。 |
|
|
製品 |
現在のユーザーとマシンに対してインストールまたはアドバタイズされた一連の製品すべてを列挙する StringList オブジェクトを返します。 |
|
|
ProductsEx |
Product オブジェクトのコレクションを列挙します。 |
|
|
ProductState |
製品のインストール状態情報を返します。 |
|
|
QualifierDescription |
修飾されたコンポーネントを記述するテキスト文字列を返します。 |
|
|
RelatedProducts |
プロパティ テーブルに UpgradeCode プロパティが指定されている現在のユーザーとマシンについて、インストールまたはアドバタイズされた一連の製品すべてを列挙する StringList オブジェクトを返します。 |
|
|
ShortcutTarget |
ショートカットを調べて、製品、機能名、コンポーネント (使用可能な場合) を返します。 |
|
|
SummaryInformation |
パッケージまたは変換の概要情報ストリームのプロパティの確認、更新、追加に使用できる SummaryInfo オブジェクトを返します。 |
|
|
UILevel |
読み取り/書き込み |
現在のプロセス空間内で後続のパッケージを開いて処理するときに使われるユーザー インターフェイスの種類を示します。 |
|
Version |
Windows インストーラーの現在のバージョンの文字列表現を返します。 |
必要条件
| 要件 | 値 |
|---|---|
| バージョン |
Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー |
| [DLL] |
|
| IID |
IID_IInstaller が 000C1090-0000-0000-C000-000000000046 として定義されている |
こちらもご覧ください