Product.InstallProperty メソッド

  • [アーティクル]

InstallProperty プロパティは、この製品のインスタンスのプロパティの値です。

このプロパティは、Product オブジェクトの ProductCode、UserSid、Context と、要求されたプロパティをパラメーターとして使用して、MsiGetProductInfoEx 関数を呼び出します。

構文

Product.InstallProperty(
  property
)

パラメーター

property

取得するプロパティを指定します。 次の一覧のプロパティは、既にインストールされているアプリケーションからのみ取得できます。 必須のプロパティは使用できることが保証されていますが、他のプロパティはそのプロパティが設定されている場合にしか使用できません。 各プロパティの設定方法については、示されているインストーラーのプロパティへのリンクを参照してください。

インストールされているプロパティ 説明
INSTALLPROPERTY_PRODUCTSTATE
 製品の状態。アドバタイズ済みの場合は "1"、インストール済みの場合は "5" として文字列形式で返されます。
INSTALLPROPERTY_HELPLINK
 サポート リンク。 詳細については、ARPHELPLINK プロパティを参照してください。
INSTALLPROPERTY_HELPTELEPHONE
 電話をサポートします。 詳細については、ARPHELPTELEPHONE プロパティを参照してください。
INSTALLPROPERTY_INSTALLDATE
 この製品が最後に保守を受けた日時。 このプロパティの値は、パッチが適用または製品から削除されるたびに、または /v コマンド ライン オプションを使用して製品を修復するたびに置き換えられます。 製品が修復もパッチも受けたことがない場合、このプロパティの値は製品がこのコンピューターにインストールされた日時です。
INSTALLPROPERTY_INSTALLEDPRODUCTNAME
 インストールされている製品名。 詳細については、ProductName プロパティを参照してください。
INSTALLPROPERTY_INSTALLLOCATION
 インストール場所。 詳細については、ARPINSTALLLOCATION プロパティを参照してください。
INSTALLPROPERTY_INSTALLSOURCE
 インストール ソース。 詳細については、SourceDir プロパティを参照してください。
INSTALLPROPERTY_LOCALPACKAGE
 ローカルにキャッシュされたパッケージ。
INSTALLPROPERTY_PUBLISHER
 公開者。 詳細については、Manufacturer プロパティを参照してください。
INSTALLPROPERTY_URLINFOABOUT
 URL 情報。 詳細については、ARPURLINFOABOUT プロパティを参照してください。
INSTALLPROPERTY_URLUPDATEINFO
 URL 更新情報。 詳細については、ARPURLUPDATEINFO プロパティを参照してください。
INSTALLPROPERTY_VERSIONMINOR
 ProductVersion プロパティから派生したマイナー製品バージョン。
INSTALLPROPERTY_VERSIONMAJOR
 ProductVersion プロパティから派生したメジャー製品バージョン。
INSTALLPROPERTY_VERSIONSTRING
 製品のバージョン。 詳細については、ProductVersion プロパティを参照してください。

 

既にインストールされているアプリケーションから製品 ID、登録済みの所有者、または登録済みの会社を取得するには、プロパティ を次のいずれかのテキスト文字列値に設定します。

値 説明
ProductID 製品 ID。 詳細については、ProductID プロパティを参照してください。
RegCompany この製品を使用するものとして登録された会社。
RegOwner この製品を使用するものとして登録された所有者。

 

製品のインスタンスの種類を取得するには、プロパティを次の値に設定します。 このプロパティは、アドバタイズまたはインストールされた製品で使用できます。

値 説明
InstanceType 値が見つからないか 0 の場合、通常の製品インストールを示します。 値 1 は、複数のインスタンス変換と MSINEWINSTANCE プロパティを使用してインストールされた製品を示します。 Windows Server 2003 または Windows XP (SP1 適用) で実行するインストーラーで使用できます。 詳細については、「製品とパッチの複数のインスタンスをインストールする」を参照してください。

 

次の一覧のプロパティは、アドバタイズされているアプリケーションからも取得できます。 これらのプロパティは、現在のユーザー アカウント以外のユーザー アカウントの per-user-unmanaged (ユーザーごとのアンマネージド) コンテキストでインストールされている製品インスタンスでは取得できません。

アドバタイズされたプロパティ 説明
INSTALLPROPERTY_TRANSFORMS 変換。
INSTALLPROPERTY_LANGUAGE 製品の言語。
INSTALLPROPERTY_PRODUCTNAME 人間が判読できる製品名。 詳細については、ProductName プロパティを参照してください。
INSTALLPROPERTY_ASSIGNMENTTYPE 製品がユーザーごとに提供またはインストールされている場合は 0 です。 製品がすべてのユーザー用に、コンピューターごとに提供またはインストールされている場合は 1 です。
INSTALLPROPERTY_PACKAGECODE この製品のインストール元のパッケージの識別子。 詳細については、「パッケージ コード」を参照してください。
INSTALLPROPERTY_VERSION ProductVersion プロパティから派生した製品バージョン。
INSTALLPROPERTY_PRODUCTICON パッケージのプライマリ アイコン。 詳細については、ARPPRODUCTICON プロパティを参照してください。
INSTALLPROPERTY_PACKAGENAME 元のインストール パッケージの名前。
INSTALLPROPERTY_AUTHORIZED_LUA_APP 値 1 は、ユーザー アカウント制御 (UAC) の修正プログラムの適用を使用して管理者以外が保守できる製品を示します。 値が見つからないか 0 の場合、最小特権のパッチ適用が有効になっていないことを示します。 Windows インストーラー 3.0 以降で使用可能。

 

戻り値

このメソッドは値を返しません。

解説

呼び出しが成功した場合、プロパティには値が文字列として含まれています。

必要条件

要件 値
バージョン
 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 2000 上の Windows インストーラー 3.0 以降
[DLL]
Msi.dll
IID
 IID_IProduct が 000C10A0-0000-0000-C000-000000000046 として定義されている

こちらもご覧ください

Product

Windows インストーラー 2.0 以前でのサポート対象外