呼叫 SetupWriteTextLog

SetupWriteTextLog 會將具有安裝事件相關資訊的單一專案新增至 SetupAPI 文字記錄檔。

如 文字記錄區段本文的格式中所述，記錄專案的格式包含下欄欄位：

entry_prefix time_stamp event_category indentation formatted_message

若要呼叫 SetupWriteTextLog，應用程式會提供下列資訊：

• 呼叫 SetupGetThreadLogToken或其中一個系統定義記錄標記，在文字記錄檔中取得之區段的 記錄權杖。 如果記錄權杖與文字記錄區段相關聯， SetupWriteTextLog 就會在該區段中寫入記錄專案。 否則， SetupWriteTextLog 會將記錄專案新增至未包含在文字記錄區段中的記錄部分。 此外， SetupWriteTextLog 是否寫入記錄專案，以及 安裝程式WriteTextLog 寫入專案的文字記錄檔，取決於系統定義的記錄權杖值。

  如需記錄權杖的詳細資訊，請參閱 設定和取得執行緒的記錄權杖。

• 啟用 文字記錄的事件類別目錄中所述的其中一個事件類別目錄。 如果已啟用文字記錄檔的專案事件類別目錄， SetupWriteTextLog 會將專案新增至文字記錄檔;否則， SetupWriteTextLog 不會將專案寫入文字記錄檔。

• 旗標值，這個旗標值是系統定義的常數，指定事件層級、縮排深度，以及是否要包含時間戳記。 設定 文字記錄檔的事件層級中會說明事件層級。 如果為文字記錄檔設定的事件層級大於或等於專案的事件層級， SetupWriteTextLog 會將記錄專案寫入至文字記錄檔;否則， SetupWriteTextLog 不會將記錄專案寫入文字記錄檔。 藉由使用縮排，可以排列格式化的訊息，讓區段中的資訊更容易閱讀和瞭解。 如需詳細資訊，請參閱 撰寫縮排記錄專案。

• printf相容的格式字串，可格式化訊息和格式字串後面的逗號分隔變數清單。

• 以逗號分隔的變數清單，其值會由 printf相容的格式字串格式化。

如需如何呼叫 SetupWriteTextLog 以記錄不是錯誤或警告之事件的相關資訊，請參閱 撰寫資訊記錄專案。

如需如何呼叫 SetupWriteTextLog 以記錄錯誤或警告相關資訊的範例，請參閱 撰寫錯誤或警告記錄專案。