Partager via


SetupInstallFromInfSectionA, 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.]

La fonction SetupInstallFromInfSection exécute toutes les directives d’une section d’installation de fichier INF.

Si le registre ou le fichier est modifié, l’appelant de cette fonction doit disposer de privilèges pour écrire dans le répertoire système ou cible.

Syntaxe

WINSETUPAPI BOOL SetupInstallFromInfSectionA(
  HWND                Owner,
  HINF                InfHandle,
  PCSTR               SectionName,
  UINT                Flags,
  HKEY                RelativeKeyRoot,
  PCSTR               SourceRootPath,
  UINT                CopyFlags,
  PSP_FILE_CALLBACK_A MsgHandler,
  PVOID               Context,
  HDEVINFO            DeviceInfoSet,
  PSP_DEVINFO_DATA    DeviceInfoData
);

Paramètres

Owner

Pointeur facultatif vers le handle de fenêtre vers la fenêtre qui possède toutes les boîtes de dialogue générées pendant l’installation, par exemple pour l’invite de disque ou la copie de fichiers. Si Propriétaire n’est pas spécifié, ces boîtes de dialogue deviennent des fenêtres de niveau supérieur.

InfHandle

Gérez le fichier INF qui contient la section à traiter.

SectionName

Nom de la section Installer dans le fichier INF à traiter.

Flags

Contrôle les actions à effectuer. Les indicateurs peuvent être une combinaison des valeurs suivantes.

SPINST_INIFILES

Effectuez des opérations de fichier INI (lignes UpdateInis, UpdateIniFields dans la section Installer en cours de traitement).

SPINST_REGISTRY

Effectuer des opérations de Registre (Lignes AddReg, DelReg dans la section Installer en cours de traitement).

SPINST_INI2REG

Effectuez des opérations INI-file to Registry (lignes Ini2Reg dans la section Installer en cours de traitement).

SPINST_LOGCONFIG

Cet indicateur est utilisé uniquement lors de l’installation d’un pilote de périphérique.

Effectuez des opérations de configuration logique (lignes LogConf de la section Installer en cours de traitement). Cet indicateur est utilisé uniquement si DeviceInfoSet et DeviceInfoData sont spécifiés.

Pour plus d’informations sur l’installation des pilotes de périphérique, LogConf, DeviceInfoSet ou DeviceInfoData, consultez le Guide du programmeur DDK.

SPINST_FILES

Effectuez des opérations de fichier (lignes CopyFiles, DelFiles, RenFiles dans la section Installer en cours de traitement).

SPINST_ALL

Effectuez toutes les opérations d’installation.

SPINST_REGISTERCALLBACKAWARE

Lors de l’utilisation de la directive INF RegisterDlls pour auto-inscrire des DLL sur Windows 2000, les appelants de SetupInstallFromInfSection peuvent recevoir des notifications sur chaque fichier à mesure qu’il est inscrit ou non inscrit. Pour envoyer une notification SPFILENOTIFY_STARTREGISTRATION ou SPFILENOTIFY_ENDREGISTRATION à la routine de rappel, incluez SPINST_REGISTERCALLBACKAWARE plus SPINST_REGSVR ou SPINST_UNREGSVR. L’appelant doit également définir le paramètre MsgHandler .

SPINST_REGSVR

Pour envoyer une notification à la routine de rappel lors de l’inscription d’un fichier, incluez SPINST_REGISTERCALLBACKAWARE plus SPINST_REGSVR dans Indicateurs. L’appelant doit également spécifier le paramètre MsgHandler .

SPINST_UNREGSVR

Pour envoyer une notification à la routine de rappel lors de la désinscription d’un fichier, incluez SPINST_REGISTERCALLBACKAWARE plus SPINST_UNREGSVR dans les indicateurs. L’appelant doit également spécifier le paramètre MsgHandler .

RelativeKeyRoot

Paramètre facultatif qui doit être spécifié si Les indicateurs incluent SPINST_REGISTRY ou SPINST_INI2REG. Gérez vers une clé de Registre à utiliser comme racine lorsque le fichier INF spécifie HKR comme clé. Notez que ce paramètre est ignoré si SetupInstallFromInfSection est appelé avec l’ensemble facultatif DeviceInfoSet et DeviceInfoData .

SourceRootPath

Racine source pour les copies de fichiers. Par exemple, A :\ ou \pegasus\win\install. Si Flags inclut SPINST_FILES et Que SourceRootPath a la valeur NULL, le système fournit un chemin d’accès racine par défaut.

CopyFlags

Paramètre facultatif qui doit être spécifié si Flags inclut SPINST_FILES. Spécifie les indicateurs à passer à la fonction SetupQueueCopySection lorsque les fichiers sont mis en file d’attente pour copie. Ces indicateurs peuvent être une combinaison des valeurs suivantes.

SP_COPY_DELETESOURCE

Supprimez le fichier source en cas de copie réussie. L’appelant n’est pas averti en cas d’échec de la suppression.

SP_COPY_REPLACEONLY

Copiez le fichier uniquement si cela remplace un fichier au niveau du chemin d’accès de destination.

SP_COPY_NEWER_OR_SAME

Examinez chaque fichier copié pour voir si ses ressources de version indiquent qu’il s’agit de la même version ou d’une version non plus récente qu’une copie existante sur la cible.

Les informations de version de fichier utilisées lors des vérifications de version sont celles spécifiées dans les membres dwFileVersionMS et dwFileVersionLS d’une structure VS_FIXEDFILEINFO , telles que renseignées par les fonctions de version. Si l’un des fichiers n’a pas de ressources de version, ou s’il a des informations de version identiques, le fichier source est considéré comme plus récent.

Si le fichier source n’est pas égal à la version ou à une version plus récente, et que CopyMsgHandler est spécifié, l’appelant est averti et peut annuler la copie. Si CopyMsgHandler n’est pas spécifié, le fichier n’est pas copié.

SP_COPY_NEWER_ONLY

Examinez chaque fichier copié pour voir si ses ressources de version indiquent qu’il n’est pas plus récent qu’une copie existante sur la cible. Si le fichier source est plus récent mais que la version n’est pas égale à la cible existante, le fichier est copié.

SP_COPY_NOOVERWRITE

Vérifiez si le fichier cible existe et, le cas échéant, informez l’appelant qui peut opposer son veto à la copie. Si CopyMsgHandler n’est pas spécifié, le fichier n’est pas remplacé.

SP_COPY_NODECOMP

Ne décompressez pas le fichier. Lorsque cet indicateur est défini, le fichier cible ne reçoit pas la forme non compressée du nom source (le cas échéant). Par exemple, la copie de f :/x86\cmd.ex_ dans \install\temp génère un fichier cible de \install\temp\cmd.ex_. Si l’indicateur SP_COPY_NODECOMP n’a pas été spécifié, le fichier est décompressé et la cible est appelée \install\temp\cmd.exe. La partie nom de fichier de DestinationName, si elle est spécifiée, est supprimée et remplacée par le nom de fichier du fichier source. Lorsque SP_COPY_NODECOMP est spécifié, aucune information de langue ou de version ne peut être vérifiée.

SP_COPY_LANGUAGEAWARE

Examinez chaque fichier copié pour voir si sa langue diffère de la langue d’un fichier existant déjà sur la cible. Si c’est le cas et que CopyMsgHandler est spécifié, l’appelant est averti et peut annuler la copie. Si CopyMsgHandler n’est pas spécifié, le fichier n’est pas copié.

SP_COPY_SOURCE_ABSOLUTE

SourceFile est un chemin d’accès source complet. Ne le recherchez pas dans la section SourceDisksNames du fichier INF.

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot est la partie de chemin d’accès complet du fichier source. Ignorez la source relative spécifiée dans la section SourceDisksNames du fichier INF du média source où se trouve le fichier. Cet indicateur est ignoré si SP_COPY_SOURCE_ABSOLUTE est spécifié.

SP_COPY_FORCE_IN_USE

Si la cible existe, se comporter comme si elle était en cours d’utilisation et mettre en file d’attente le fichier pour la copie au prochain redémarrage du système.

SP_COPY_IN_USE_NEEDS_REBOOT

Si le fichier a été utilisé pendant l’opération de copie, informez l’utilisateur que le système doit être redémarré. Cet indicateur est utilisé uniquement lors de l’appel ultérieur de SetupPromptReboot ou SetupScanFileQueue.

SP_COPY_NOSKIP

Ne donnez pas à l’utilisateur la possibilité d’ignorer un fichier.

SP_COPY_FORCE_NOOVERWRITE

Vérifiez si le fichier cible existe et, dans l’affirmative, le fichier n’est pas remplacé. L’appelant n’est pas averti.

SP_COPY_FORCE_NEWER

Examinez chaque fichier copié pour voir si ses ressources de version (ou les horodatages pour les fichiers non image) indiquent qu’il n’est pas plus récent qu’une copie existante sur la cible. Si le fichier copié n’est pas plus récent, le fichier n’est pas copié. L’appelant n’est pas averti.

SP_COPY_WARNIFSKIP

Si l’utilisateur tente d’ignorer un fichier, avertissez-le que le fait d’ignorer un fichier peut affecter l’installation. (Utilisé pour les fichiers critiques du système.)

MsgHandler

Pointeur vers la routine de rappel. La routine de rappel doit être au format FileCallback. Pour plus d’informations, consultez Notifications.

Ce paramètre est facultatif uniquement si le paramètre Flags n’inclut pas SPINST_FILES, SPINST_REGISTERCALLBACKAWARE plus SPINST_REGSVR ou SPINST_UNREGSVR.

MsgHandler doit être défini si Les indicateurs incluent SPINST_FILES. Dans ce cas, une notification est envoyée à la routine de rappel lorsque la file d’attente de fichiers est validée avec SetupCommitFileQueue.

MsgHandler doit être défini si les indicateurs incluent SPINST_REGISTERCALLBACKAWARE plus SPINST_REGSVR ou SPINST_UNREGSVR. Dans ce cas , un SPFILENOTIFY_STARTREGISTRATION ou SPFILENOTIFY_ENDREGISTRATION est envoyé à la routine de rappel une fois chaque fois qu’un fichier est inscrit ou désinscrit à l’aide de la directive INF RegisterDlls sur Windows 2000.

Context

Valeur à passer à la fonction de rappel lorsque la file d’attente de fichiers créée par cette routine en interne est validée via SetupCommitFileQueue. Le paramètre Context est facultatif uniquement si le paramètre Flags n’inclut pas SPINST_FILES. Ce paramètre doit être spécifié si Indicateurs inclut SPINST_FILES.

DeviceInfoSet

Pointeur facultatif vers un handle vers un jeu d’informations d’appareil. Pour plus d’informations sur les fonctions de configuration du programme d’installation d’appareil, consultez le Guide du programmeur DDK.

DeviceInfoData

Pointeur facultatif vers un pointeur vers la structure SP_DEVINFO_DATA qui fournit un contexte à un élément spécifique dans le jeu spécifié par DeviceInfoSet. Pour plus d’informations sur les fonctions de configuration du programme d’installation d’appareil, consultez le Guide du programmeur DDK.

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

Si un répertoire UNC est spécifié comme répertoire cible d’une opération de copie de fichiers, vous devez vous assurer qu’il existe avant d’appeler SetupInstallFromInfSection. Les fonctions d’installation ne case activée pas pour l’existence de et ne créent pas de répertoires UNC. Si le répertoire UNC cible n’existe pas, l’installation du fichier échoue.

Cette fonction nécessite un fichier INF Windows. Certains formats de fichiers INF plus anciens peuvent ne pas être pris en charge.

Notes

L’en-tête setupapi.h définit SetupInstallFromInfSection 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. La combinaison 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
Ensemble d’API ext-ms-win-setupapi-classinstallers-l1-1-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Fonctions

Vue d'ensemble

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallServicesFromInfSection