SetupRemoveFileLogEntryA 函式（setupapi.h）

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

SetupRemoveFileLogEntry 函式會從檔案記錄中移除專案或區段。

語法

WINSETUPAPI BOOL SetupRemoveFileLogEntryA(
  [in] HSPFILELOG FileLogHandle,
  [in] PCSTR      LogSectionName,
  [in] PCSTR      TargetFilename
);

[in] FileLogHandle

SetupInitializeFileLog所傳回的檔案記錄檔句柄。呼叫端在初始化記錄檔時，不得傳遞SPFILELOG_QUERYONLY。

[in] LogSectionName

null 的指標-terminated 字串，指定記錄檔內名稱邏輯群組的名稱。非系統記錄的必要專案。否則，LogSectionName 可能會 NULL。

[in] TargetFilename

null 的指標-terminated 字串，指定目標上存在的檔名。此名稱應該以任何對呼叫端有意義的格式。如果 NULL，則會移除logSectionName 所指定的區段。無法移除主區段。

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

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

注意

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