Funzione SetupSetSourceListW (setupapi.h)

Articolo
11/20/2024

[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 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 (MRU) 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 non viene chiamato SetupCancelTemporarySourceList o SetSourceList viene chiamato di nuovo.

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

Si noti è 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 SRCLIST_TEMPORARY.

[in] SourceList

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

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

Osservazioni

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