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

Статья
11/20/2024

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. 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 определяет SetupRemoveFileLogEntry как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	setupapi.h
библиотеки	Setupapi.lib
DLL	Setupapi.dll

См. также

Функции

Обзор

SetupLogFile

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