Funzione SetupQuerySourceListA (setupapi.h)
[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 SetupQuerySourceList esegue una query sull'elenco corrente delle origini di installazione. L'elenco viene compilato dagli elenchi di sistema e specifici dell'utente e potenzialmente sottoposto a override da un elenco temporaneo (vedere SetupSetSourceList).
Sintassi
WINSETUPAPI BOOL SetupQuerySourceListA(
[in] DWORD Flags,
[in, out] PCSTR **List,
[in, out] PUINT Count
);
Parametri
[in] Flags
Specifica l'elenco da eseguire per la query. Questo parametro può essere qualsiasi combinazione dei valori seguenti.
SRCLIST_SYSTEM
Eseguire una query sull'elenco di sistema.
SRCLIST_USER
Eseguire una query sull'elenco per utente.
SRCLIST_NOSTRIPPLATFORM
In genere, tutti i percorsi vengono rimossi da un componente specifico della piattaforma se è il componente finale. Ad esempio, un percorso archiviato nel Registro di sistema come f:\x86 viene restituito come f:. Se questo flag viene specificato, il componente specifico della piattaforma non viene rimosso.
[in, out] List
Puntatore a una variabile in cui questa funzione restituisce un puntatore a una matrice di origini. Usare una stringa con terminazione Null. Il chiamante deve liberare questa matrice con una chiamata a SetupFreeSourceList.
[in, out] Count
Puntatore a una variabile in cui questa funzione restituisce il numero di origini nell'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 ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Nota
L'intestazione setupapi.h definisce SetupQuerySourceList 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 |