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


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

[Эта функция доступна для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. 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

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

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

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

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

Примечание Этот флаг применяется только к архитектурам x86, amd64 и ia64.  Он игнорируется во всех остальных архитектурах.
 
Примечание Если пакет драйвера содержит файлы, скопированные в DestinationDir, использующий DirId 13, этот флаг принудительно игнорируется.
 
Примечание Рекомендуется использовать DiUninstallDriver, чтобы удалить пакет драйвера вместо использования этого флага.
 

[in] Reserved

Установите значение null.

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

Эта функция возвращает BOOL WINSETUPAPI.

Замечания

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
заголовка setupapi.h
библиотеки Setupapi.lib
DLL Setupapi.dll
набор API ext-ms-win-setupapi-classinstallers-l1-1-2 (представлено в Windows 10 версии 10.0.14393)

См. также

Функции

Обзор

SetupCopyOEMInf

DiUninstallDriver