Funzione SetupUninstallOEMInfA (setupapi.h)

Articolo
11/20/2024

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupUninstallOEMInf disinstalla un file inf specificato e qualsiasi file con estensione 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 disporre di 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 segue.

Bandiera	Significato
SUOI_FORCEDELETE 0x0001	La funzione SetupUninstallOEMInf verifica innanzitutto se sono presenti dispositivi installati usando il file inf. Non è necessario che un dispositivo sia 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 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 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 DestinationDir che usa un DirId di 13, questo flag di forza viene ignorato. Nota È consigliabile usare DiUninstallDriver per rimuovere un pacchetto driver anziché usare questo flag.

Bandiera

Significato

SUOI_FORCEDELETE
0x0001

La funzione SetupUninstallOEMInf verifica innanzitutto se sono presenti dispositivi installati usando il file inf. Non è necessario che un dispositivo sia 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 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 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 DestinationDir che usa un DirId di 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.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	setupapi.h
libreria	Setupapi.lib
dll	Setupapi.dll
set di API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotto in Windows 10, versione 10.0.14393)

Vedere anche

Funzioni

panoramica

SetupCopyOEMInf

diUninstallDriver

Condividi tramite