Funzione SetupUninstallOEMInfA (setupapi.h)

Articolo
08/26/2023

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupUninstallOEMInf disinstalla un file con estensione inf specificato e qualsiasi file pnf associato. Se il file inf è stato installato con un catalogo per i driver di firma, viene rimosso anche il catalogo. Un chiamante di questa funzione deve avere privilegi amministrativi, in caso contrario la funzione non riesce.

Sintassi

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

Parametri

[in] InfFileName

Nome file, senza percorso, del file inf nella directory Windows Inf da disinstallare.

[in] Flags

Questo parametro può essere impostato come indicato di seguito.

Flag	Significato
SUOI_FORCEDELETE 0x0001	La funzione SetupUninstallOEMInf verifica innanzitutto se sono presenti dispositivi installati usando il file inf. Un dispositivo non deve essere presente per essere rilevato come usando il file inf. Se questo flag non è impostato e la funzione trova un dispositivo attualmente installato che è stato installato usando questo file con estensione inf, il file inf non viene rimosso. Se questo flag è impostato, il file inf viene rimosso se la funzione trova un dispositivo installato con questo file con estensione inf. Nota Questo flag si applica solo alle architetture x86, amd64 e ia64. Viene ignorato in tutte le altre architetture. Nota Se il pacchetto driver contiene file copiati in un oggetto DestinationDir che usa un Valore DirId pari a 13, questo flag di forza viene ignorato. Nota È consigliabile usare DiUninstallDriver per rimuovere un pacchetto driver anziché usare questo flag.

Flag

Significato

SUOI_FORCEDELETE
0x0001

La funzione SetupUninstallOEMInf verifica innanzitutto se sono presenti dispositivi installati usando il file inf. Un dispositivo non deve essere presente per essere rilevato come usando il file inf.

Se questo flag non è impostato e la funzione trova un dispositivo attualmente installato che è stato installato usando questo file con estensione inf, il file inf non viene rimosso.

Se questo flag è impostato, il file inf viene rimosso se la funzione trova un dispositivo installato con questo file con estensione inf.

Nota Questo flag si applica solo alle architetture x86, amd64 e ia64. Viene ignorato in tutte le altre architetture.

Nota Se il pacchetto driver contiene file copiati in un oggetto DestinationDir che usa un Valore DirId pari a 13, questo flag di forza viene ignorato.

Nota È consigliabile usare DiUninstallDriver per rimuovere un pacchetto driver anziché usare questo flag.

[in] Reserved

Impostare su Null.

Valore restituito

Questa funzione restituisce WINSETUPAPI BOOL.

Commenti

Nota

L'intestazione setupapi.h definisce SetupUninstallOEMInf come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	setupapi.h
Libreria	Setupapi.lib
DLL	Setupapi.dll
Set di API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotta in Windows 10, versione 10.0.14393)

Vedi anche

Condividi tramite