Uso de componentes calificados

Los componentes calificados son un método de direccionamiento indirecto y se pueden usar para agrupar componentes con funcionalidad paralela en categorías.

Para devolver la ruta de acceso completa e instalar un componente calificado, llame a MsiProvideQualifiedComponent o MsiProvideQualifiedComponentEx.

Para enumerar todos los calificadores de componente calificados y cadenas descriptivas, llame a MsiEnumComponentQualifiers.

Agrupación de componentes en una categoría de componente calificado

  1. Debe haber un registro en la tabla Component para cada componente que se incluya en la nueva categoría de componentes calificados. Cree los campos de la tabla Component igual que para los componentes normales. Tenga en cuenta que cada componente calificado debe tener un GUID de identificador de componente único especificado en la columna ComponentId de la tabla Component.
  2. Genere una cadena de texto calificador para cada componente calificado. El calificador debe ser una cadena de texto única que se pueda generar fácilmente al buscar un componente calificado. Por ejemplo, si los componentes de la categoría se califican por idioma, el identificador de configuración regional numérico (LCID) es una cadena de calificador razonable.
  3. Agregue un registro en la tabla PublishComponent para cada componente calificado. Escriba los identificadores de componente calificado de la columna Component de la tabla Component en la columna Component_ de la tabla PublishComponent. Escriba las cadenas de calificador de cada componente calificado en la columna Qualifier. Escriba una cadena localizada que se muestre al usuario y que describa el componente calificado en la columna AppData opcional. Se debe colocar una cadena explicativa en el campo AppData, como "Diccionario de francés", en lugar de simplemente el LCID numérico. Escriba el nombre de la característica que usa este componente en la columna Feature_. El identificador de característica de este campo también debe aparecer en la columna Feature de la tabla Feature.
  4. Genere un GUID de categoría para esta categoría de componentes calificados. Debe ser un GUID válido. Si usa una utilidad como GUIDGEN para generar el GUID, asegúrese de que solo contenga letras mayúsculas. Para cada componente calificado de esta categoría, escriba el GUID de categoría en el campo ComponentId de la tabla PublishComponent.

En el ejemplo siguiente se muestra cómo se crea la categoría "FAX Templates" de componentes calificados en las tablas Component, Feature y PublishComponent.

Tabla PublishComponent

ComponentId Calificador: AppData Feature_ Component_
{GUID de categoría FAX Template} 1033 Plantilla para inglés de EE. UU. FAXTemplate FAXTemplateENU
  1041 Plantilla para japonés FAXTemplate FAXTemplateJPN
  1054 Plantilla para tailandés FAXTemplate FAXTemplateTHA
  1031 Plantilla para alemán FAXTemplate FAXTemplateDEU

 

Tabla Component (tabla parcial)

Componente ComponentId
FAXTemplateENU {GUID de componente para FAX Template (inglés EE. UU.)}
FAXTemplateJPN {GUID de componente para FAX Template (japonés)}
FAXTemplateTHA {GUID de componente para FAX Template (tailandés)}
FAXTemplateDEU {GUID de componente para FAX Template (alemán)}

 

Tabla Feature (tabla parcial)

Característica
FAXTemplate
FAXTemplate
FAXTemplate
FAXTemplate