Partilhar via


Usando componentes qualificados

Componentes qualificados são um método de indireção e podem ser usados para agrupar componentes com funcionalidade paralela em categorias.

Para devolver o caminho completo e instalar um componente qualificado , chame MsiProvideQualifiedComponent ou MsiProvideQualifiedComponentEx.

Para enumerar todos os qualificadores de componentes qualificados e cadeias de caracteres descritivas, chame MsiEnumComponentQualifiers.

Agrupar componentes em uma categoria de componente qualificado

  1. Deve haver um registro na tabela Componente para cada componente incluído na nova categoria de componentes qualificados. Crie os campos na tabela Componente da mesma forma que para componentes comuns. Observe que cada componente qualificado deve ter um GUID de ID de componente exclusivo inserido na coluna ComponentId da tabela Component.
  2. Gere uma cadeia de texto qualificadora para cada componente qualificado. O qualificador deve ser uma cadeia de caracteres de texto exclusiva que possa ser facilmente gerada ao procurar um componente qualificado. Por exemplo, se os componentes na categoria estiverem sendo qualificados por idioma, o identificador de localidade numérica (LCID) será uma cadeia de caracteres de qualificador razoável.
  3. Adicione um registro na tabela PublishComponent para cada componente qualificado. Insira os identificadores de componentes qualificados da coluna Component da tabela Component na coluna Component_ da tabela PublishComponent. Insira as cadeias de caracteres qualificadoras para cada componente qualificado na coluna Qualificador. Insira uma cadeia de caracteres localizada para ser exibida ao usuário e descreva o componente qualificado na coluna AppData opcional. Uma cadeia de caracteres explicativa deve ser colocada no campo AppData, como "Dicionário de francês", em vez de apenas o LCID numérico. Insira o nome do recurso que usa esse componente na coluna Feature_. O identificador de funcionalidade neste campo também deve ser listado na coluna Funcionalidade da tabela .
  4. Gere um GUID de categoria para esta categoria de componentes qualificados. Este deve ser um GUID válido de . Se você usar um utilitário como GUIDGEN para gerar o GUID, certifique-se de que ele contém apenas letras maiúsculas. Para cada componente qualificado nesta categoria, insira o GUID da categoria no campo ComponentId da tabela PublishComponent.

O exemplo a seguir ilustra como a categoria "Modelos de FAX" de componentes qualificados é criada nas tabelas Component, Feature e PublishComponent.

Tabela do Componente de Publicação

ComponentId Eliminatórias AppData Funcionalidade_ Componente_
{GUID da categoria do modelo FAX} 1033 Modelo em inglês dos EUA Modelo de Fax FAXTemplateENU
  1041 Modelo japonês Modelo de FAX FAXTemplateJPN
  1054 Modelo tailandês Modelo de Fax FAXTemplateTHA
  1031 Modelo alemão Modelo de FAX FAXTemplateDEU

 

Tabela de componentes (tabela parcial)

Componente ComponentId
FAXTemplateENU {GUID do componente FAX Template (inglês dos EUA)}
FAXTemplateJPN {Template FAX (Japonês) GUID do componente}
FAXTemplateTHA {GUID do componente Modelo de Fax tailandês}
FAXTemplateDEU {Modelo de Fax (alemão) GUID do componente}

 

Tabela de funcionalidades (tabela parcial)

Funcionalidade
Modelo de Fax
FAXTemplate
Modelo de Fax
Modelo de Fax