共用方式為

SetupLogErrorA 函式 （setupapi.h）

  • 發行項

[此函式可用於需求一節所指出的作業系統。 後續版本可能會變更或無法使用。 安裝程式API 不應該再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]

SetupLogError 函式會將錯誤訊息寫入記錄檔。 它的目的是要在 Windows 安裝期間使用，但一律可供使用。 安裝作業系統之後，不應該使用它 ，而是應該改用事件記錄檔。

語法

WINSETUPAPI BOOL SetupLogErrorA(
  [in] LPCSTR      MessageString,
  [in] LogSeverity Severity
);

參數

[in] MessageString

應儲存至安裝程式記錄檔之字串的指標。 訊息的結尾必須是傳回換行字元組合 （\r\n）。 您應該使用以 Null 結尾的字串。 以 Null 結尾的字串不應超過目的地緩衝區的大小。 訊息一律會儲存至動作記錄檔，setupact.log。 如果 嚴重性LogSevWarning、LogSevError或 LogSevFatalError，安裝程式也會將訊息儲存至錯誤記錄檔setuperr.log。 這兩個記錄都會儲存在 Windows 目錄中。

[in] Severity

訊息嚴重性，下列其中一項：LogSevInformation、LogSevWarning、LogSevError或 LogSevFatalError。

傳回值

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

  • 動作記錄檔旨在記錄安裝 Windows 期間對系統所做的所有修改。
  • 錯誤記錄檔僅適用於 Windows 安裝期間的錯誤。
  • 安裝程式可能會進一步格式化 MessageString 參數（不過現在不會進行其他處理）。
  • 錯誤記錄檔會在系統設定結束時向用戶顯示。

注意

setupapi.h 標頭會將 SetupLogError 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 setupapi.h
連結庫 Setupapi.lib
DLL Setupapi.dll
API 集 ext-ms-win-setupapi-logging-l1-1-0 （在 Windows 8 中引進）

另請參閱

函式

概觀