Funzione SetupRemoveFromSourceListA (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 SetupRemoveFromSourceList rimuove un valore dall'elenco delle origini di installazione per l'utente corrente o il sistema. Gli elenchi di sistema e utente vengono uniti in fase di esecuzione.

Un chiamante di questa funzione è necessario disporre di privilegi amministrativi. In caso contrario, la funzione ha esito negativo.

Sintassi

WINSETUPAPI BOOL SetupRemoveFromSourceListA(
  [in] DWORD Flags,
  [in] PCSTR Source
);

Parametri

[in] Flags

Specifica l'origine da rimuovere dall'elenco. Questo parametro può essere qualsiasi combinazione dei valori seguenti.

SRCLIST_SYSTEM

Rimuovere l'origine nell'elenco per sistema. Il chiamante deve essere un amministratore.

SRCLIST_USER

Rimuovere l'origine nell'elenco per utente.

SRCLIST_SYSIFADMIN

Se il chiamante è un amministratore, l'origine viene rimossa dall'elenco per sistema; se il chiamante non è un amministratore, l'origine viene rimossa dall'elenco per utente per l'utente corrente.

Nota Se un elenco temporaneo è attualmente in uso (vedere SetupSetSourceList), i flag precedenti vengono ignorati e l'origine viene rimossa dall'elenco temporaneo.

SRCLIST_SUBDIRS

Rimuovere tutte le sottodirectory dell'origine.

[in] Source

Puntatore a una stringa con terminazione Null che specifica l'origine da rimuovere dall'elenco.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Nota

L'intestazione setupapi.h definisce SetupRemoveFromSourceList 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