Funzione SetupAddToSourceListA (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 SetupAddToSourceList aggiunge un valore all'elenco delle origini di installazione per l'utente corrente o il sistema. Se il valore esiste già, viene rimosso prima, in modo che le voci duplicate non vengano create.

Per un chiamante di questa funzione sono necessari privilegi amministrativi, in caso contrario la funzione ha esito negativo.

Sintassi

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

Parametri

[in] Flags

Elenco a cui verrà aggiunta l'origine. Questo parametro può essere una combinazione dei valori seguenti.

SRCLIST_SYSTEM

Aggiungere l'origine all'elenco per sistema. Il chiamante deve essere un amministratore.

SRCLIST_USER

Aggiungere l'origine all'elenco utenti.

SRCLIST_SYSIFADMIN

Se il chiamante è un amministratore, l'origine viene aggiunta all'elenco per sistema; se il chiamante non è membro del gruppo locale amministratori, l'origine viene aggiunta all'elenco utenti per utente corrente.

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

SRCLIST_APPEND

Aggiungere l'origine alla fine dell'elenco. Se questo flag non è specificato, l'origine viene aggiunta all'inizio dell'elenco.

[in] Source

Puntatore all'origine da aggiungere all'elenco. È consigliabile usare una stringa con terminazione Null.

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 SetupAddToSourceList 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 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