Функция SetupRemoveFileLogEntryA (setupapi.h)

Статья
08/26/2023

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]

Функция SetupRemoveFileLogEntry удаляет запись или раздел из журнала файлов.

Синтаксис

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

Параметры

[in] FileLogHandle

Обработайте журнал файлов, возвращенный SetupInitializeFileLog. Вызывающий объект не должен передавать SPFILELOG_QUERYONLY при инициализации файла журнала.

[in] LogSectionName

Указатель на строку, завершающуюся null, которая указывает имя для логической группы имен в файле журнала. Требуется для несистемных журналов. В противном случае logSectionName может иметь значение NULL.

[in] TargetFilename

Указатель на строку, завершающуюся значением NULL, которая указывает имя файла в том виде, в котором он существует в целевом объекте. Это имя должно быть в любом формате, содержательном для вызывающего объекта. Если значение РАВНО NULL, раздел, указанный параметром LogSectionName , удаляется. Невозможно удалить раздел main.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Заголовок setupapi.h определяет SetupRemoveFileLogEntry как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	setupapi.h
Библиотека	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SetupLogFile

Поделиться через