SetupWriteTextLog は、インストール イベントに関する情報を含む 1 つのエントリを SetupAPI テキスト ログに追加します。
「テキスト ログ セクション本文の形式」で説明されているように、ログ エントリの形式は次のフィールドで構成されます。
entry_prefix time_stamp event_category indentation formatted_message
SetupWriteTextLog を呼び出すために、アプリケーションは次の情報を提供します。
SetupGetThreadLogToken を呼び出すことによって取得されたテキスト ログ内のセクションのログ トークン、またはシステム定義のログ トークンの 1 つ。 ログ トークンがテキスト ログ セクションに関連付けられている場合、 SetupWriteTextLog はそのセクションにログ エントリを書き込みます。 それ以外の場合、 SetupWriteTextLog は、テキスト ログ セクションに含まれていないログの一部にログ エントリを追加します。 さらに、 SetupWriteTextLog がログ エントリを書き込むかどうか、および SetupWriteTextLog がエントリを書き込むテキスト ログは、システム定義のログ トークン値によって異なります。
ログ トークンの詳細については、「 スレッドのログ トークンの設定と取得」を参照してください。
「テキスト ログのイベント カテゴリの有効化」で説明されている イベント カテゴリの 1 つ。 エントリのイベント カテゴリがテキスト ログに対して有効になっている場合、 SetupWriteTextLog はテキスト ログにエントリを追加します。それ以外の場合、 SetupWriteTextLog はテキスト ログにエントリを書き込みます。
イベント レベル、インデントの深さ、およびタイム スタンプを含めるかどうかを指定する、システム定義定数のビットごとの OR であるフラグ値。 イベント レベルについては、テキスト ログのイベント レベルの設定を参照してください。 テキスト ログに設定されたイベント レベルがエントリのイベント レベル以上の場合、 SetupWriteTextLog はログ エントリをテキスト ログに書き込みます。それ以外の場合、 SetupWriteTextLog はログ エントリをテキスト ログに書き込むことはありません。 インデントを使用すると、セクション内の情報を読みやすく理解しやすくするために、書式設定されたメッセージを配置できます。 詳細については、「 インデントされたログ エントリの書き込み」を参照してください。
メッセージと書式指定文字列の後に続くコンマ区切り変数のリストの両方を書式設定する printf 互換の書式指定文字列。
printf互換の書式指定文字列によって書式設定された値を含む変数の、コンマ区切りリスト。
SetupWriteTextLog を呼び出して、エラーまたは警告ではないイベントに関する情報をログに記録する方法の例については、「情報ログ エントリの書き込み」を参照してください。
SetupWriteTextLog を呼び出してエラーまたは警告に関する情報をログに記録する方法の例については、「エラーまたは警告ログ エントリの書き込み」を参照してください。