Funzione SetupUninstallOEMInfW (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 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 ha esito negativo.

Sintassi

WINSETUPAPI BOOL SetupUninstallOEMInfW(
  [in] PCWSTR 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.

Contrassegno	Significato
SUOI_FORCEDELETE 0x0001	La funzione SetupUninstallOEMInf controlla 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 nel pacchetto driver sono presenti file copiati in destinationDir che utilizza un DirId pari a 13, questo flag force viene ignorato. Nota È consigliabile usare DiUninstallDriver per rimuovere un pacchetto driver anziché usare questo flag.

Contrassegno

Significato

SUOI_FORCEDELETE
0x0001

La funzione SetupUninstallOEMInf controlla 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 nel pacchetto driver sono presenti file copiati in destinationDir che utilizza un DirId pari a 13, questo flag force 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
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 (introdotto in Windows 10, versione 10.0.14393)

Vedi anche

Condividi tramite