次の方法で共有

MsiEnableLogA 関数 (msi.h)

  • [アーティクル]

MsiEnableLog 関数は、呼び出し元プロセスで開始されるすべての後続のインストールのログ モードを設定します。

構文

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR szLogFile,
  [in] DWORD  dwLogAttributes
);

パラメーター

[in] dwLogMode

ログ モードを指定します。 このパラメーターには、次の値のうち 1 つ以上を指定できます。

価値 意味
INSTALLLOGMODE_FATALEXIT
 メモリまたは致命的な終了情報からログアウトします。
INSTALLLOGMODE_ERROR
 エラー メッセージをログに記録します。
INSTALLLOGMODE_EXTRADEBUG
 ハンドル作成情報などの追加のデバッグ情報をログ ファイルに送信します。

Windows 2000 および Windows XP: この機能はサポートされていません。
INSTALLLOGMODE_WARNING
 警告メッセージをログに記録します。
INSTALLLOGMODE_USER
 ユーザー要求をログに記録します。
INSTALLLOGMODE_INFO
 表示されないステータス メッセージをログに記録します。
INSTALLLOGMODE_RESOLVESOURCE
 有効なソースの場所を決定する要求。
INSTALLLOGMODE_OUTOFDISKSPACE
 ディスク領域が不足していることを示します。
INSTALLLOGMODE_ACTIONSTART
 新しいインストール アクションの開始をログに記録します。
INSTALLLOGMODE_ACTIONDATA
 インストール アクションを使用してデータ レコードをログに記録します。
INSTALLLOGMODE_COMMONDATA
 ユーザー インターフェイスの初期化のパラメーターをログに記録します。
INSTALLLOGMODE_PROPERTYDUMP
 終了時にプロパティ値をログに記録します。
INSTALLLOGMODE_VERBOSE
 INSTALLLOGMODE_EXTRADEBUGを除き、他のすべてのログ モードで情報をログに記録します。 これにより、ユーザーにとって一般的には役に立たない大量の情報がログ ファイルに送信されます。 テクニカル サポートに使用できます。
INSTALLLOGMODE_LOGONLYONERROR
 ログ情報は収集されますが、ログ ファイルに保存される頻度は低くなります。 これにより、一部のインストールのパフォーマンスを向上させることができますが、大規模なインストールの利点はほとんどありません。 インストールが成功すると、ログ ファイルが削除されます。 インストールが失敗した場合、すべてのログ情報がログ ファイルに保存されます。

Windows インストーラー 2.0: このログ モードは使用できません。

[in] szLogFile

ログ ファイルへの完全パスを保持する文字列を指定します。 null を入力するとログ記録が無効になります。この場合、dwlogmode は無視されます。 パスが指定されている場合、dwlogmode 0 にすることはできません。

[in] dwLogAttributes

ログ バッファーをフラッシュする頻度を指定します。

価値 意味
INSTALLLOGATTRIBUTES_APPEND
 この値が設定されている場合、インストーラーは、szLogFileで指定された既存のログを追加します。 設定しない場合、szLogFile で指定された既存のログが上書きされます。
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 各行の後にログ バッファーを強制的にフラッシュします。 この値が設定されていない場合、インストーラーは FlushFileBuffersを呼び出して 20 行後 ログ バッファーをフラッシュします。

戻り値

価値 意味
ERROR_INVALID_PARAMETER
 無効なログ モードが指定されました。
ERROR_SUCCESS
 関数は成功しました。

備考

ログ ポリシーの説明については、「システム ポリシーの」を参照してください。

この関数を使用する場合は、ログ ファイルの場所へのパスが既に存在している必要があります。 インストーラーは、ログ ファイルのディレクトリ構造を作成しません。

手記

msi.h ヘッダーは、MSIEnableLog をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント 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 インストーラーのバージョンで必要な最小 Windows Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msi.h
ライブラリ Msi.lib
DLL Msi.dll

関連項目

インターフェイスとログ関数の

ログ記録 の