InstallComponentW, fonction

Article
06/13/2023

Installe un package d’exception.

Syntaxe

void InstallComponentW(
  _In_           LPCWSTR InfPath,
  _In_opt_ const GUID    *CompGuid,
  _In_           DWORD   Flags,
  _In_opt_       INT     VerMajor,
  _In_opt_       INT     VerMinor,
  _In_opt_       INT     VerBuild,
  _In_opt_       INT     VerQFE,
  _In_opt_       LPCWSTR Name
);

Paramètres

InfPath [in]

Chemin d’accès à l’inf de l’exception à traiter.

CompGuid [in, facultatif]

GUID du composant d’exception en cours d’installation.

Indicateurs [in]

Indicateurs utilisés pour contrôler les comportements d’installation. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
COMP_FLAGS_FORCE 0x00000020	Ignore la version case activée sur les remplacements de fichiers.
COMP_FLAGS_NEEDS_UNINSTALL	Sauvegardez les fichiers mis à jour pour être utilisés par une désinstallation du composant.
COMP_FLAGS_NO_OVERWRITE	Ignore la sauvegarde des fichiers si la version du composant Exception est identique à celle d’un composant installé. Cet indicateur est utilisé dans un scénario de réinstallation.
COMP_FLAGS_NOUI 0x00000002	Supprime toute l’interface utilisateur.
COMP_FLAGS_UPDATE_DLLCACHE	Force la mise à jour du répertoire DLLCACHE lorsqu’un fichier système est mis à jour.
COMP_FLAGS_USE_SVCPACK_CACHE	Utilise les fichiers mis en cache par une installation du Service Pack Windows pour remplacer les fichiers sauvegardés.

VerMajor [in, facultatif]

Version principale du composant Exception.

VerMinor [in, facultatif]

Version mineure du composant Exception.

VerBuild [in, facultatif]

Version de build du composant Exception.

VerQFE [in, facultatif]

Révision du correctif logiciel du composant Exception.

Nom [in, facultatif]

Chaîne descriptive du composant affiché par la boîte de dialogue Protection des fichiers Windows si le système d’exploitation détecte qu’un fichier de protection de fichiers Windows est endommagé, falsifié ou endommagé.

Valeur retournée

Cette fonction retourne une valeur HRESULT (S_OK ou un code d’échec). Un code d’échec peut être vérifié par rapport à une valeur de 0x20000100 pour déterminer si l’échec est dû au fait qu’un redémarrage est nécessaire.

Notes

Les packages d’exception sont des fichiers système Windows qui sont publiés en dehors d’une version complète de Windows et qui mettent à jour les fichiers du système d’exploitation. Les packages d’exception sont créés uniquement par les équipes du système d’exploitation qui ont reçu l’autorisation de mettre à jour les fichiers système Windows.

Pour installer et désinstaller des fichiers qui ne sont pas protégés par la protection de fichiers Windows, utilisez les fonctions décrites dans Fonctions d’installation générale. Pour installer des pilotes de périphérique, les distributeurs doivent utiliser les fonctions décrites dans Fonctions d’installation de périphérique et Fonctions pnP Configuration Manager.

Cette fonction n’a pas de bibliothèque d’importation ou de fichier d’en-tête associé ; vous devez l’appeler à l’aide des fonctions LoadLibrary et GetProcAddress .

Spécifications

Condition requise	Valeur
DLL	Msoobci.dll

Partager via