共用方式為

SetupInitializeFileLogA 函式 （setupapi.h）

  • 發行項

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

SetupInitializeFileLog 函式會初始化檔案，以記錄安裝作業和結果。 這可以是系統記錄檔，其中系統會追蹤安裝為 Windows 或任何其他檔案的檔案。

語法

WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
  [in] PCSTR LogFileName,
  [in] DWORD Flags
);

參數

[in] LogFileName

要做為記錄檔之檔名的選擇性指標。 您應該使用 null-terminated 字串。 如果 Flags 不包含SPFILELOG_SYSTEMLOG，則必須指定logFileName 參數 。 如果 Flags 包含 SPFILELOG_SYSTEMLOG，則不得指定 logFileName 參數 。 此參數可以是 NULL。

[in] Flags

控制記錄檔初始化。 此參數可以是下列值的組合。

SPFILELOG_SYSTEMLOG

使用系統檔案記錄檔。 除非指定SPFILELOG_QUERYONLY，而且未指定LogFileName ，否則用戶必須是系統管理員，才能指定此選項。 請勿將SPFILELOG_SYSTEMLOG與SPFILELOG_FORCENEW搭配使用。

SPFILELOG_FORCENEW

如果記錄檔存在，請加以覆寫。 如果記錄檔存在且未指定此旗標，則任何已安裝的新檔案會新增至現有記錄檔中的清單。 請勿與SPFILELOG_SYSTEMLOG搭配指定。

SPFILELOG_QUERYONLY

開啟僅查詢的記錄檔。

傳回值

如果成功，函式會傳回記錄檔的句柄。 否則，傳回值會INVALID_HANDLE_VALUE，而且呼叫 getLastError 即可擷取記錄的錯誤。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 setupapi.h
連結庫 Setupapi.lib
DLL Setupapi.dll

另請參閱

函式

概觀

SetupLogFile

SetupTerminateFileLog