Fonction SetupSetSourceListA (setupapi.h)

Article
03/01/2024

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des pilotes de périphérique.]

La fonction SetupSetSourceList permet à l’appelant de définir la liste des sources d’installation pour l’utilisateur actuel ou le système (commun à tous les utilisateurs).

Syntaxe

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

Paramètres

[in] Flags

Spécifie le type de liste. Ce paramètre peut être une combinaison des valeurs suivantes.

SRCLIST_SYSTEM

La liste est la liste mru (Most Recently Used) par système stockée dans le Registre. L’appelant doit être membre du groupe local administrateurs.

SRCLIST_USER

La liste est la liste MRU par utilisateur stockée dans le Registre.

SRCLIST_TEMPORARY

La liste spécifiée est temporaire et sera la seule liste accessible au processus en cours jusqu’à ce que SetupCancelTemporarySourceList soit appelé ou que SetSourceList soit appelé à nouveau.

Important Si une liste temporaire est définie, les sources ne sont pas ajoutées ou supprimées des listes système ou utilisateur, même si les appels suivants à SetupAddToSourceList ou SetupRemoveFromSourceList spécifient explicitement ces listes.

Note L’un des indicateurs SRCLIST_SYSTEM, SRCLIST_USER ou SRCLIST_TEMPORARY doit être spécifié.

SRCLIST_NOBROWSE

L’utilisateur n’est pas autorisé à ajouter ou à modifier des sources lorsque SetupPromptForDisk est utilisé. Cet indicateur est généralement utilisé en combinaison avec l’indicateur SRCLIST_TEMPORARY.

[in] SourceList

Pointeur vers un tableau de chaînes à utiliser comme liste source, comme spécifié par le paramètre Flags .

[in] SourceCount

Nombre d’éléments dans le tableau pointé vers sourceList.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notes

L’en-tête setupapi.h définit SetupSetSourceList comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	setupapi.h
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll