Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

[ Image Added |../../index.htm#lansa/get_product_attribs.htm]
現在地:

Anchor
_Toc130907324
_Toc130907324
9.105 GET_PRODUCT_ATTRIBS

注意: 9.1 組み込み関数の規則      &<a href="bifcat4_04.htm"&>利用オプション&</a&>利用オプション
このBIFはインストールされた製品の属性をリストします。この戻り値の使い方および内容を理解するには、Windowsインストーラーの知識が必要です。これはインターネットなどで調べることができます。実際に以下の説明にはCヘッダー・ファイルについての記述がありますが、これにより理解を深めることができるでしょうし、ここが更に深い知識を得るための出発点になると思います。LANSAからはこの情報は提供されません。
 
引数

...

 
注:
この組み込み関数はアップグレード・コードに関連付けられた全ての製品をリストします。現在のWindowsインストーラーのドキュメントによると、1つだけのはずですが、戻された製品全てがリストされます。
システム内の全ユーザーがインストールした製品がリストされます。指定のアップグレード・コードにアクセス権がない場合もあります。
リストに属性を加えることもできますが、特定の順番にリストされることを期待しないでください。また探しているものが戻ってくると思わないようにしてください。値がリストされた場合、戻り値にERが設定され、リストから省かれることはありません。
以下の参照はCヘッダー・ファイルの定義されたwinerror.hやmsi.hの属性です。
製品属性
UpgradeCode - 38バイトGUID(入力値。任意のため、実際に使用された値がリストに戻される。)
アップグレード・コードに関連付けられた各製品に関して、以下が戻されます。
ProductCode- 38バイトGUID
InstallContext – 列挙型の値MSIINSTALLCONTEXT
SID – 製品のインスタンスが存在するアカウントのセキュリティ識別子
次の値は戻された属性IDに簡単にマップできます。例えば、INSTALLPROPERTY_INSTALLEDPRODUCTNAMEは、InstalledProductNameを戻します。Cを使って値をリストすることにより、属性の意味をWebで検索できるようになります。
    INSTALLPROPERTY_INSTALLEDPRODUCTNAME,
    INSTALLPROPERTY_PACKAGENAME           ,
    INSTALLPROPERTY_TRANSFORMS            ,
    INSTALLPROPERTY_LANGUAGE              ,
    INSTALLPROPERTY_PRODUCTNAME           ,
    INSTALLPROPERTY_ASSIGNMENTTYPE        ,
    INSTALLPROPERTY_INSTANCETYPE          ,
    INSTALLPROPERTY_AUTHORIZED_LUA_APP    ,
    INSTALLPROPERTY_PACKAGECODE           ,
    INSTALLPROPERTY_VERSION               ,
    INSTALLPROPERTY_PRODUCTICON           ,
 
   // 製品情報属性: インストール情報
 
    INSTALLPROPERTY_INSTALLEDPRODUCTNAME  ,
    INSTALLPROPERTY_VERSIONSTRING         ,
    INSTALLPROPERTY_HELPLINK              ,
    INSTALLPROPERTY_HELPTELEPHONE         ,
    INSTALLPROPERTY_INSTALLLOCATION       ,
    INSTALLPROPERTY_INSTALLSOURCE         ,
    INSTALLPROPERTY_INSTALLDATE           ,
    INSTALLPROPERTY_PUBLISHER             ,
    INSTALLPROPERTY_LOCALPACKAGE          ,
    INSTALLPROPERTY_URLINFOABOUT          ,
    INSTALLPROPERTY_URLUPDATEINFO         ,
    INSTALLPROPERTY_VERSIONMINOR          ,
    INSTALLPROPERTY_VERSIONMAJOR          ,
    INSTALLPROPERTY_PRODUCTID             ,
    INSTALLPROPERTY_REGCOMPANY            ,
    INSTALLPROPERTY_REGOWNER              ,
    INSTALLPROPERTY_INSTALLEDLANGUAGE     ,
    INSTALLPROPERTY_PRODUCTSTATE          ,
    INSTALLPROPERTY_LASTUSEDSOURCE        ,
    INSTALLPROPERTY_LASTUSEDTYPE          ,
    INSTALLPROPERTY_MEDIAPACKAGEPATH      ,
    INSTALLPROPERTY_DISKPROMPT,
 
例えば、以下にサンプル製品に戻された属性のリストがあります。属性値のフィールド長は30だけですので、多くの属性(例えばUpgradeCode,)のステータスがOVとなります。LANSAでは、標準でこの値を切り捨てるようになっています。

パッチ属性
各属性のリストはパッチ・コードから始まります。パッチ・コードのエントリーが繰り返されると、そこが別のパッチの開始となります。製品によってはパッチが多く(例えばMicrosoft Windows製品など)、動的リストの使用が推奨されています。
PatchCode – 38 byte GUID
   INSTALLPROPERTY_LOCALPACKAGE,
   INSTALLPROPERTY_PATCHTYPE,
   INSTALLPROPERTY_TRANSFORMS,
   INSTALLPROPERTY_INSTALLDATE,
   INSTALLPROPERTY_UNINSTALLABLE,
   INSTALLPROPERTY_PATCHSTATE,
   INSTALLPROPERTY_LUAENABLED,
   INSTALLPROPERTY_DISPLAYNAME,
   INSTALLPROPERTY_MOREINFOURL
[ Image Added |../../index.htm#lansa/get_product_attribs.htm]