MsiGetMode 関数 (msiquery.h)

  • [アーティクル]

MsiGetMode 関数は、表に示すように、インストーラーが現在指定されたモードで実行されているかどうかを判断するために使用されます。 関数は TRUE またはFALSE のブール値を返します。この関数に渡される特定のプロパティが現在設定されている (TRUE) か設定されていない (FALSE) かを示します。

構文

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

パラメーター

[in] hInstall

DLL カスタム アクションに提供されるインストール、または MsiOpenPackage、MsiOpenPackageEx、または MsiOpenProduct を使用して取得されたインストールを処理します。

[in] eRunMode

実行モードを指定します。 このパラメーターには、次のいずれかの値が必要です。

値 説明
MSIRUNMODE_ADMIN
 管理モードがインストールされているか、製品がインストールされています。
MSIRUNMODE_ADVERTISE
 提供情報がインストールされているか、製品がインストールまたは更新中です。
MSIRUNMODE_MAINTENANCE
 既存のインストールが変更されているか、新しいインストールが存在します。
MSIRUNMODE_ROLLBACKENABLED
 ロールバックが有効になっています。
MSIRUNMODE_LOGENABLED
 ログ ファイルがアクティブです。 インストール セッションの前に有効にされました。
MSIRUNMODE_OPERATIONS
 実行操作は決定フェーズにあります。
MSIRUNMODE_REBOOTATEND
 インストールが正常に完了した後に再起動が必要です (settable)。
MSIRUNMODE_REBOOTNOW
 インストール (settable) を続行するには、再起動が必要です。
MSIRUNMODE_CABINET
 キャビネットと メディア テーブル ファイルのファイルがインストールされています。
MSIRUNMODE_SOURCESHORTNAMES
 ソース LongFileNames は、PID_MSISOURCEの概要プロパティによって抑制されます。
MSIRUNMODE_TARGETSHORTNAMES
 ターゲットの LongFileNames は SHORTFILENAMES プロパティによって抑制されます。
MSIRUNMODE_RESERVED11
 将来利用するために予約されています。
MSIRUNMODE_WINDOWS9X
 オペレーティング システムは 9 倍のバージョンです。
MSIRUNMODE_ZAWENABLED
 オペレーティング システムでは、需要のインストールがサポートされています。
MSIRUNMODE_RESERVED14
 将来利用するために予約されています。
MSIRUNMODE_RESERVED15
 将来利用するために予約されています。
MSIRUNMODE_SCHEDULED
 インストール スクリプトの実行から呼び出されるカスタム アクション。
MSIRUNMODE_ROLLBACK
 ロールバック実行スクリプトから呼び出されるカスタム アクション。
MSIRUNMODE_COMMIT
 コミット実行スクリプトから呼び出されるカスタム アクション。

戻り値

TRUE は 、関数に渡される特定のプロパティが現在設定されていることを示します。

FALSE は 、関数に渡される特定のプロパティが現在設定されていないことを示します。

解説

遅延カスタム アクションから MsiGetMode を呼び出すときに、iRunMode のすべての実行モード値を使用できるわけではないことに注意してください。 詳細については、「 遅延実行カスタム アクションのコンテキスト情報の取得」を参照してください。

要件

   
サポートされている最小のクライアント 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 インストーラー
対象プラットフォーム Windows
ヘッダー msiquery.h
Library Msi.lib
[DLL] Msi.dll

関連項目

インストーラーの状態アクセス関数