Funzione SetupSetSourceListW (setupapi.h)

Articolo
03/01/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 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 SetupSetSourceListW(
  [in] DWORD  Flags,
  [in] PCWSTR *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 per sistema archiviato nel Registro di sistema. Il chiamante deve essere membro del gruppo locale administrators.

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 fino a quando 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 in modo esplicito tali elenchi.

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

SRCLIST_NOBROWSE

L'utente non può aggiungere o modificare le origini quando viene usato SetupPromptForDisk . Questo flag viene in genere usato in combinazione con il flag 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 a cui punta 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 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