共用方式為

寫入資訊記錄專案

  • 發行項

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

如需呼叫 SetupWriteTextLog 以記錄錯誤訊息的詳細資訊，請參閱 呼叫 SetupWriteTextLog 以記錄錯誤或警告專案。

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

  • LogToken 是透過呼叫 SetupGetThreadLogToken 取得的記錄權杖值，或是 記錄權杖中所述的其中一個系統定義記錄標記值。

  • 類別 設定為 TXTLOG_VENDOR，表示記錄專案是由廠商提供的應用程式所建立。 事件類別描述于 啟用文字記錄檔的事件類別。

  • 旗標 設定為位 OR，TXTLOG_DETAILS和TXTLOG_TIMESTAMP。 在此範例中，縮排深度不會變更，而且目前的縮排深度先前設定為五個單空白字元文字空格。 如需如何變更縮排深度的詳細資訊，請參閱 撰寫縮排記錄專案。 事件層級描述于設定 文字記錄主題的事件層級 。

  • 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