Funzione SetupQuerySourceListA (setupapi.h)

Articolo
03/05/2024

[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 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 di cui eseguire 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.

Nota Se il sistema e gli elenchi di utenti vengono entrambi recuperati, vengono uniti a tali elementi nell'elenco di sistema che vengono visualizzati per primi.

Nota Se non viene specificato alcun flag precedente, viene restituito l'intero elenco corrente (unito).

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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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