Funzione SetupAddToSourceListA (setupapi.h)
[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.
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 |