Fonction SetupAddToSourceListA (setupapi.h)

Article
08/26/2023

[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 SetupAddToSourceList ajoute une valeur à la liste des sources d’installation pour l’utilisateur actuel ou le système. Si la valeur existe déjà, elle est d’abord supprimée, afin que les entrées en double ne soient pas créées.

Un appelant de cette fonction doit disposer de privilèges d’administration, sinon la fonction échoue.

Syntaxe

WINSETUPAPI BOOL SetupAddToSourceListA(
  [in] DWORD Flags,
  [in] PCSTR Source
);

Paramètres

[in] Flags

Liste à laquelle la source sera ajoutée. Ce paramètre peut être n’importe quelle combinaison des valeurs suivantes.

SRCLIST_SYSTEM

Ajoutez la source à la liste par système. L’appelant doit être un administrateur.

SRCLIST_USER

Ajoutez la source à la liste par utilisateur.

SRCLIST_SYSIFADMIN

Si l’appelant est un administrateur, la source est ajoutée à la liste par système ; si l’appelant n’est pas membre du groupe local administrateurs, la source est ajoutée à la liste par utilisateur pour l’utilisateur actuel.

Note Si une liste temporaire est actuellement utilisée (consultez SetupSetSourceList), les indicateurs précédents sont ignorés et la source est ajoutée à la liste temporaire.

SRCLIST_APPEND

Ajoutez la source à la fin de la liste. Si cet indicateur n’est pas spécifié, la source est ajoutée au début de la liste.

[in] Source

Pointeur vers la source à ajouter à la liste. Vous devez utiliser une chaîne terminée par null.

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 SetupAddToSourceList comme un 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


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