SetupUninstallOEMInfA (setupapi.h)

Artikel
08/26/2023

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Pemasang Windows untuk mengembangkan alat penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar peranti.]

Fungsi SetupUninstallOEMInf menghapus instalasi file .inf tertentu dan file .pnf terkait. Jika file .inf diinstal dengan katalog untuk penandatanganan driver, katalog juga dihapus. Penelepon fungsi ini harus memiliki hak istimewa administratif, jika tidak, fungsi gagal.

Sintaks

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

Parameter

[in] InfFileName

Nama file, tanpa jalur, dari file .inf di direktori Windows Inf yang akan dihapus instalasinya.

[in] Flags

Parameter ini dapat diatur sebagai berikut.

Bendera	Makna
SUOI_FORCEDELETE 0x0001	Fungsi SetupUninstallOEMInf terlebih dahulu memeriksa apakah ada perangkat yang diinstal menggunakan file .inf. Perangkat tidak perlu ada untuk dideteksi sebagai menggunakan file .inf. Jika bendera ini tidak diatur dan fungsi menemukan perangkat yang saat ini diinstal yang diinstal menggunakan file .inf ini, file .inf tidak dihapus. Jika bendera ini diatur, file .inf dihapus apakah fungsi menemukan perangkat yang diinstal dengan file .inf ini. Catatan Bendera ini hanya berlaku untuk arsitektur x86, amd64, dan ia64. Ini diabaikan pada semua arsitektur lainnya. Catatan Jika paket driver memiliki file apa pun yang disalin ke DestinationDir yang menggunakan DirId 13, maka bendera paksa ini diabaikan. Catatan Disarankan untuk menggunakan DiUninstallDriver untuk menghapus paket driver alih-alih menggunakan bendera ini.

Bendera

Makna

SUOI_FORCEDELETE
0x0001

Fungsi SetupUninstallOEMInf terlebih dahulu memeriksa apakah ada perangkat yang diinstal menggunakan file .inf. Perangkat tidak perlu ada untuk dideteksi sebagai menggunakan file .inf.

Jika bendera ini tidak diatur dan fungsi menemukan perangkat yang saat ini diinstal yang diinstal menggunakan file .inf ini, file .inf tidak dihapus.

Jika bendera ini diatur, file .inf dihapus apakah fungsi menemukan perangkat yang diinstal dengan file .inf ini.

Catatan Bendera ini hanya berlaku untuk arsitektur x86, amd64, dan ia64. Ini diabaikan pada semua arsitektur lainnya.

Catatan Jika paket driver memiliki file apa pun yang disalin ke DestinationDir yang menggunakan DirId 13, maka bendera paksa ini diabaikan.

Catatan Disarankan untuk menggunakan DiUninstallDriver untuk menghapus paket driver alih-alih menggunakan bendera ini.

[in] Reserved

Atur ke null.

Menampilkan nilai

Fungsi ini mengembalikan WINSETUPAPI BOOL.

Keterangan

Catatan

Header setupapi.h mendefinisikan SetupUninstallOEMInf sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll
Set API	ext-ms-win-setupapi-classinstallers-l1-1-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

Bagikan melalui