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

Статья
08/26/2023

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

Функция SetupUninstallOEMInf удаляет указанный INF-файл и любой связанный PNF-файл. Если INF-файл был установлен с каталогом для подписывания драйверов, каталог также удаляется. Вызывающий объект этой функции должен иметь права администратора, в противном случае функция завершается ошибкой.

Синтаксис

WINSETUPAPI BOOL SetupUninstallOEMInfA(
  [in] PCSTR InfFileName,
  [in] DWORD Flags,
  [in] PVOID Reserved
);

Параметры

[in] InfFileName

Имя inf-файла в каталоге Windows Inf, который требуется удалить, без пути.

[in] Flags

Этот параметр можно задать следующим образом.

Flag	Значение
SUOI_FORCEDELETE 0x0001	Функция SetupUninstallOEMInf сначала проверяет, установлены ли какие-либо устройства с помощью INF-файла. Устройство не обязательно должно присутствовать, чтобы его можно было обнаружить как использующего INF-файл. Если этот флаг не установлен, а функция находит установленное в данный момент устройство, которое было установлено с помощью этого INF-файла, INF-файл не удаляется. Если этот флаг установлен, INF-файл удаляется, если функция находит устройство, установленное с этим INF-файлом. Примечание Этот флаг применяется только к архитектуре x86, amd64 и ia64. Он игнорируется во всех остальных архитектурах. Примечание Если в пакете драйвера есть файлы, скопированные в DestinationDir , использующий DirId 13, этот флаг силы игнорируется. Примечание Вместо этого флага рекомендуется использовать DiUninstallDriver для удаления пакета драйверов.

Flag

Значение

SUOI_FORCEDELETE
0x0001

Функция SetupUninstallOEMInf сначала проверяет, установлены ли какие-либо устройства с помощью INF-файла. Устройство не обязательно должно присутствовать, чтобы его можно было обнаружить как использующего INF-файл.

Если этот флаг не установлен, а функция находит установленное в данный момент устройство, которое было установлено с помощью этого INF-файла, INF-файл не удаляется.

Если этот флаг установлен, INF-файл удаляется, если функция находит устройство, установленное с этим INF-файлом.

Примечание Этот флаг применяется только к архитектуре x86, amd64 и ia64. Он игнорируется во всех остальных архитектурах.

Примечание Если в пакете драйвера есть файлы, скопированные в DestinationDir , использующий DirId 13, этот флаг силы игнорируется.

Примечание Вместо этого флага рекомендуется использовать DiUninstallDriver для удаления пакета драйверов.

[in] Reserved

Задайте значение NULL.

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

Эта функция возвращает ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ WINSETUPAPI.

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

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	setupapi.h
Библиотека	Setupapi.lib
DLL	Setupapi.dll
Набор API	ext-ms-win-setupapi-classinstallers-l1-1-2 (представлено в Windows 10 версии 10.0.14393)

См. также

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