InstallHinfSectionA, fonction (setupapi.h)

[Cette fonction peut être utilisée 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 installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer les pilotes de périphérique.]

InstallHinfSection est une fonction de point d’entrée exportée par Setupapi.dll que vous pouvez utiliser pour exécuter une section d’un fichier .inf. InstallHinfSection peut être appelé en appelant l’utilitaire Rundll32.exe comme décrit dans la section Remarques.

Le prototype de la fonction InstallHinfSection suit la forme de toutes les fonctions de point d’entrée utilisées avec Rundll32.exe.

Si un fichier est copié ou modifié, l’appelant de cette fonction doit disposer de privilèges pour écrire dans le répertoire cible. S’il existe des services en cours d’installation, l’appelant de cette fonction doit avoir accès au Gestionnaire de contrôle des services.

Syntaxe

void InstallHinfSectionA(
  [in] HWND      Window,
  [in] HINSTANCE ModuleHandle,
  [in] PCSTR     CommandLine,
  [in] INT       ShowCommand
);

Paramètres

[in] Window

Handle de fenêtre parente. En règle générale, hwnd a la valeur Null.

[in] ModuleHandle

Réservé et doivent avoir la valeur Null.

[in] CommandLine

Pointeur vers la mémoire tampon contenant la ligne de commande. Vous devez utiliser une chaîne terminée par null.

[in] ShowCommand

Réservé et doit être égal à zéro.

Valeur de retour

None

Remarques

Notez que trois exportations existent : InstallHinfSection (pour RunDll32), InstallHinfSectionA et InstallHinfSectionW.

Pour exécuter une section Install d’un fichier .inf spécifié, vous pouvez appeler InstallHinfSection avec le Rundll32.exe à l’aide de la syntaxe suivante.

RUNDLL32.EXE SETUPAPI.DLL,Chemin du mode <>>de section<>InstallHinfSection<

Cette opération transmet le « chemin> du mode<>section<>» à CmdLineBuffer.<

Votre programme peut également appeler InstallHinfSection, InstallHinfSectionA ou InstallHinfSectionW directement, en définissant le paramètre CmdLineBuffer sur ce qui suit.

"<section> <mode> <path>"

Où path est le chemin d’accès complet au fichier .inf, mode est le paramètre de mode de redémarrage, et section est n’importe quelle section Installer dans le fichier .inf. Le séparateur de virgules entre SETUPAPI.DLL et InstallHinfSection sur la ligne de commande est requis. Notez qu’il ne peut pas y avoir d’espace blanc sur la ligne de commande entre la virgule et SETUPAPI.DLL ou InstallHinfSection.

Il est recommandé de spécifier le chemin d’accès complet au fichier .inf comme chemin d’accès.

Vous pouvez spécifier une section Installer dans le fichier .inf en tant que section. Les espaces ne sont pas autorisés.

Vous devez utiliser une combinaison des valeurs suivantes pour mode. Vous devez inclure 128 pour définir le chemin d’accès par défaut de l’installation à l’emplacement de l’inf. Sinon, un inf fourni par le système est supposé. Ajoutez des valeurs pour spécifier le redémarrage. Notez que seules les valeurs 128 ou 132 sont recommandées. D’autres valeurs peuvent entraîner le redémarrage inutile ou le redémarrage de l’ordinateur lorsque cela est nécessaire.

Par exemple, la ligne de commande suivante exécute la section DefaultInstall du fichier Shell.inf. Si le programme d’installation détermine qu’un redémarrage est nécessaire, l’utilisateur est invité à entrer une boîte de dialogue « Redémarrer l’ordinateur, Oui/Non ».

RUNDLL32.EXE SETUPAPI.DLL,InstallHinfSection DefaultInstall 132 C :\WINDOWS\INF\SHELL. INF

Configuration requise