Utilisation de composants qualifiés

Les composants qualifiés sont une méthode d’indirection et peuvent être utilisés pour regrouper des composants avec des fonctionnalités parallèles en catégories.

Pour renvoyer le chemin d’accès complet et installer un composant qualifié, appelez MsiProvideQualifiedComponent ou MsiProvideQualifiedComponentEx.

Pour énumérer tous les qualificateurs de composants qualifiés et les chaînes descriptives, appelez MsiEnumComponentQualifiers.

Pour regrouper des composants dans une catégorie de composants qualifiés

1. Il doit y avoir un enregistrement dans la table Composant pour chaque composant inclus dans la nouvelle catégorie de composants qualifiés. Créez les champs de la table Composant de la même façon que pour les composants ordinaires. Notez que chaque composant qualifié doit avoir un GUID d’ID de composant unique entré dans la colonne ComponentId de la table Composant.
2. Générez une chaîne de texte de qualificateur pour chaque composant qualifié. Le qualificateur doit être une chaîne de texte unique qui peut être facilement générée lors de la recherche d’un composant qualifié. Par exemple, si les composants de la catégorie sont qualifiés par la langue, l’identificateur de paramètres régionaux numériques (LCID) est une chaîne de qualificateur raisonnable.
3. Ajoutez un enregistrement dans la table PublishComponent pour chaque composant qualifié. Entrez les identificateurs de composant qualifié de la colonne Composant de la table Component dans la colonne Component_ de la table PublishComponent. Entrez les chaînes de qualificateur pour chaque composant qualifié dans la colonne Qualificateur. Entrez une chaîne localisée à afficher pour l’utilisateur et décrivant le composant qualifié dans la colonne AppData facultative. Une chaîne d’explication doit être placée dans le champ AppData, par exemple « Dictionnaire français », plutôt que simplement dans le LCID numérique. Entrez le nom de la fonctionnalité qui utilise ce composant dans la colonne Feature_. L’identificateur de fonctionnalité dans ce champ doit également être répertorié dans la colonne Fonctionnalité de la table Fonctionnalité.
4. Générez un GUID de catégorie pour cette catégorie de composants qualifiés. Il doit s’agir d’un GUID valide. Si vous utilisez un utilitaire tel que GUIDGEN pour générer le GUID, assurez-vous qu’il contient uniquement des lettres majuscules. Pour chaque composant qualifié de cette catégorie, entrez le GUID de catégorie dans le champ ComponentId de la table PublishComponent.

L’exemple suivant montre comment la catégorie « Modèles de FAX » des composants qualifiés est créée dans les tables Composant, Fonctionnalité et PublishComponent.

Table PublishComponent

ComponentId	Qualificateur	AppData	Feature_	Component_
{GUID de catégorie de modèle FAX}	1033	Modèle anglais us	FAXTemplate	FAXTemplateENU
	1041	Modèle japonais	FAXTemplate	FAXTemplateJPN
	1054	Modèle thaïlandais	FAXTemplate	FAXTemplateTHA
	1031	Modèle allemand	FAXTemplate	FAXTemplateDEU

 

Table Composant (table partielle)

Composant	ComponentId
FAXTemplateENU	{GUID du composant de modèle FAX (anglais américain)}
FAXTemplateJPN	{GUID du composant de modèle FAX (japonais)}
FAXTemplateTHA	{GUID du composant de modèle FAX (thaïlandais)}
FAXTemplateDEU	{GUID du composant de modèle FAX (allemand)}

 

Table Fonctionnalité (table partielle)

Fonctionnalité
FAXTemplate
FAXTemplate
FAXTemplate
FAXTemplate