Compartilhar via


Componentes qualificados

Um componente qualificado é um método de indireção de nível único, semelhante a um ponteiro. Componentes qualificados são usados principalmente para agrupar componentes com funcionalidade paralela em categorias. Por exemplo, se você tiver 30 componentes listados na tabela componente que são o mesmo modelo de fax do Microsoft Word localizado em 30 idiomas, você poderá agrupá-los em uma categoria de componentes qualificados usando a tabela PublishComponent.

Componentes qualificados são inseridos na tabela Componente da mesma forma que os componentes comuns. Cada componente deve ter um GUID de ID de componente exclusivo e um identificador de componente especificados na tabela Componente. Além disso, os componentes qualificados são associados a um GUID de categoria e um qualificador de cadeia de texto na tabela PublishComponent. Componentes qualificados são referenciados pelo GUID da categoria e pelo qualificador, que aponta apenas para o componente comum na tabela Componente.

Por exemplo, um GUID de ID de componente qualificado pode apontar para diferentes versões de idioma de uma DLL de recurso. Nesse caso, o grupo de DLLs de recursos localizados compreende a categoria e as cadeias de caracteres LCID (identificadores de localidade numérica) são comumente usadas como qualificadores. Um desenvolvedor pode criar um pacote de instalação que usa esses componentes qualificados para fazer o seguinte:

  • Localize o caminho para uma versão de idioma específica da DLL do recurso usando MsiProvideQualifiedComponent ou MsiProvideQualifiedComponentEx e instale o recurso.
  • Determine todas as versões de idioma da DLL de recurso que estão presentes chamando MsiEnumComponentQualifiers.
  • Prepare o aplicativo para dar suporte a idiomas adicionais. Um pacote de idiomas futuro para o aplicativo pode usar o componente qualificado para adicionar mais versões de idioma da DLL do recurso.

Para obter mais informações, consulte Usando componentes qualificados.