Funzione SetupSetSourceListA (setupapi.h)

Articolo
03/15/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 SetupSetSourceList consente al chiamante di impostare l'elenco delle origini di installazione per l'utente corrente o il sistema (comune a tutti gli utenti).

Sintassi

WINSETUPAPI BOOL SetupSetSourceListA(
  [in] DWORD Flags,
  [in] PCSTR *SourceList,
  [in] UINT  SourceCount
);

Parametri

[in] Flags

Specifica il tipo di elenco. Questo parametro può essere una combinazione dei valori seguenti.

SRCLIST_SYSTEM

L'elenco è l'elenco usato più di recente (MRU) usato per sistema archiviato nel Registro di sistema. Il chiamante deve essere membro del gruppo locale amministratori.

SRCLIST_USER

L'elenco è l'elenco MRU per utente archiviato nel Registro di sistema.

SRCLIST_TEMPORARY

L'elenco specificato è temporaneo e sarà l'unico elenco accessibile al processo corrente finché SetupCancelTemporarySourceList viene chiamato o SetSourceList viene chiamato di nuovo.

Importante Se viene impostato un elenco temporaneo, le origini non vengono aggiunte o eliminate dagli elenchi di sistema o utente, anche se le chiamate successive a SetupAddToSourceList o SetupRemoveFromSourceList specificano esplicitamente tali elenchi.

Nota È necessario specificare uno dei flag SRCLIST_SYSTEM, SRCLIST_USER o SRCLIST_TEMPORARY.

SRCLIST_NOBROWSE

L'utente non è autorizzato ad aggiungere o modificare le origini quando viene usato SetupPromptForDisk . Questo flag viene in genere usato in combinazione con il flag di SRCLIST_TEMPORARY.

[in] SourceList

Puntatore a una matrice di stringhe da usare come elenco di origine, come specificato dal parametro Flags .

[in] SourceCount

Numero di elementi nella matrice puntati da SourceList.

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 SetupSetSourceList come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante 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

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