SetupRemoveFileLogEntry

The SetupRemoveFileLogEntry function removes an entry or section from a file log.

BOOL SetupRemoveFileLogEntry(
  HSPFILELOG FileLogHandle,  // handle to the log file
  PCTSTR LogSectionName, // optional, name to group by
  PCTSTR TargetFileName  // optional, name in target dir
);
 

Parameters

FileLogHandle

Supplies the handle to the file log as returned by SetupInitializeFileLog. The caller must not have passed SPFILELOG_QUERYONLY when the log file was initialized.

LogSectionName

This optional parameter supplies the name for a logical grouping of names within the log file. Required for non-system logs. Otherwise, LogSectionName is optional.

TargetFileName

This optional parameter supplies the name of the file as it exists on the target. This name should be in whatever format is meaningful to the caller. If not specified, the section specified by LogSectionName is removed. The main section for Windows NT files cannot be removed.

Return Values

If the function succeeds, the return value is a non-zero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

QuickInfo

  Windows NT: Use version 4.0 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in setupapi.h.
  Import Library: Link with setupapi.lib.

See Also

Overview, Functions, SetupLogFile