共用方式為

撰寫信息日誌條目

下列範例示範應用程式通常如何呼叫 SetupWriteTextLog ，以在 SetupAPI 文字記錄 中寫入不是警告訊息或錯誤訊息的資訊專案。

如需呼叫 SetupWriteTextLog 以記錄錯誤訊息的資訊，請參閱 呼叫 SetupWriteTextLog 來記錄錯誤或警告項目。

應用程式會呼叫 SetupWriteTextLog，並提供下列參數值：

  • LogToken 被設定為一個記錄令牌值，該值要么是透過呼叫 SetupGetThreadLogToken 獲得的，要么是 記錄令牌 中所描述的系統定義記錄令牌值之一。

  • 類別 設定為 TXTLOG_VENDOR，表示日誌條目是由廠商提供的應用程式所建立。 事件類別描述在啟用文字日誌的事件類別中。

  • 旗標 設定為 TXTLOG_DETAILS 和 TXTLOG_TIMESTAMP 的位元 OR 結果。 在此範例中，縮排深度不會變更，而且目前的縮排深度先前設定為五個單一空間文字空間。 如需變更縮排深度的相關資訊，請參閱 撰寫縮排日誌條目。 在 設定文字記錄檔的事件層級 主題中會說明事件層級。

  • MessageStr 設定為 TEXT("感興趣的變數: = %d")。

  • 逗號分隔參數清單會提供 一個變數 SomeVariable，其對應於 MessageStr 中的 “%d” 字段。

//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR; 
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1;   // The variable whose value will be logged

SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);

如果已啟用TXTLOG_VENDOR事件類別目錄，且已針對裝置安裝文字記錄檔設定TXTLOG_DETAILS事件層級，則此程式代碼會以下列格式在裝置安裝記錄中建立專案，其中時間戳會取代為實際的時間戳。

     2005/02/13 22:06:28.109:    :  Variable of interest: Abc = 1
  • Last updated on