Tabela de Recursos

A Tabela de Recursos define a estrutura de árvore lógica dos recursos e contém as colunas mostradas na tabela a seguir.

Coluna	Tipo	Chave	Nullable
Característica	identificador de	Y	N
Feature_Parent	identificador de	N	Y
Título	de Texto	N	Y
Descrição	de Texto	N	Y
Exposição	inteiro	N	Y
Nível	inteiro	N	N
Diretório_	identificador de	N	Y
Atributos	inteiro	N	N

 

Colunas

Recurso

A chave primária usada para identificar um registro de recurso específico. O valor nesse campo não deve exceder um comprimento máximo de 38 caracteres.

Feature_Parent

Uma chave opcional de um registro pai na mesma tabela.

A chave aponta para a coluna Recurso. Se o recurso pai não estiver selecionado, esse recurso não será instalado. Um valor nulo nesse campo indica que esse recurso não tem um pai e é um item raiz. A coluna Feature_Parent não deve ser igual à coluna Recurso do mesmo registro.

Nota

A profundidade máxima de qualquer recurso é 16. Um erro de 2701 resultará se houver um recurso que exceda essa profundidade máxima.

 

Título do

Uma cadeia de caracteres curta de texto que identifica um recurso.

Essa cadeia de caracteres é listada como um item pelo de Controle SelectionTree do de Diálogo de Seleção.

Descrição do

Uma cadeia de caracteres mais longa de texto que descreve um recurso.

Essa cadeia de caracteres localizável é exibida pelo de Controle de Texto do de Diálogo de Seleção de.

Exibição

O número neste campo especifica a ordem na qual o recurso deve ser exibido na interface do usuário.

O valor também determina se o recurso é exibido inicialmente expandido ou recolhido. Se o valor for nulo ou 0 (zero), o registro não será exibido.

• Se o valor for ímpar, o nó do recurso será expandido inicialmente.
• Se o valor estiver par, o nó do recurso será recolhido inicialmente.

Nível de

O nível de instalação inicial desse recurso. O processamento do da Tabela de Condições de pode modificar o valor de nível.

Um nível de instalação de 0 (zero) desabilita o item e impede que ele seja exibido. Um recurso com um nível de instalação igual a 0 (zero) não é instalado durante nenhuma instalação, incluindo instalações administrativas. Para obter mais informações, consulte as informações de "Nível de Instalação" na seção Comentários deste tópico.

Directory_

A coluna Directory_ especifica o nome de um diretório que pode ser configurado por um de Diálogo de Seleção.

Como esse campo é uma chave no tabela de diretório, o diretório especificado deve ser listado na primeira coluna da Tabela de Diretório. Você deve inserir um de Propriedade Pública nesta coluna para tornar o diretório configurável e exibir um botão procurar na caixa de diálogo Seleção .

Atributos de

A opção de execução remota para recursos que não estão instalados e para os quais nenhuma solicitação de estado de recurso é feita usando qualquer uma das propriedades a seguir.

• de propriedade ADDLOCAL
• da propriedadeADDSOURCE
• propriedade ADDDEFAULT
• propriedade COMPADDLOCAL
• propriedade COMPADDSOURCE
• propriedade FILEADDLOCAL
• propriedade FILEADDSOURCE
• de propriedade REMOVE
• da propriedade REINSTALL
• de propriedade ADVERTISE

Adicione os bits indicados ao valor total desta coluna para incluir uma opção de execução remota.

• Se esse campo estiver em branco, o valor será padrão como 0 (zero), msidbFeatureAttributesFavorLocal.
• Se o nível de instalação do recurso for 0 (zero) ou maior ou igual ao nível de instalação atual, nenhuma alteração será feita no estado do recurso.

Nome	Decimal	Hexadecimal	Descrição
msidbFeatureAttributesFavorLocal	0	0x0000	Os componentes desse recurso que não estão marcados para instalação da origem são instalados localmente. Um componente compartilhado por dois ou mais recursos, alguns dos quais são definidos como msidbFeatureAttributesFavorLocal e alguns para msidbFeatureAttributesFavorSource, é instalado localmente. Os componentes marcados como msidbComponentAttributesSourceOnly no da Tabela de Componentes são sempre executados no CD/servidor de origem. Os bits msidbFeatureAttributesFavorLocal e msidbFeatureAttributesFavorSource funcionam com recursos não listados pela propriedade ADVERTISE.
msidbFeatureAttributesFavorSource	1	0x0001	Componentes desse recurso não marcados para instalação local são instalados para serem executados a partir do servidor ou CD-ROM de origem. Um componente compartilhado por dois ou mais recursos, alguns dos quais são definidos como msidbFeatureAttributesFavorLocal e alguns para msidbFeatureAttributesFavorSource, é instalado para ser executado localmente. Os componentes marcados como msidbComponentAttributesLocalOnly na tabela de componentes sempre são instalados localmente. Os bits msidbFeatureAttributesFavorLocal e msidbFeatureAttributesFavorSource funcionam com recursos não listados pela propriedade ADVERTISE.
msidbFeatureAttributesFollowParent	2	0x0002	Definir esse atributo e o estado do recurso é o mesmo que o estado do pai do recurso. Você não poderá usar essa opção se o recurso estiver localizado na raiz de uma árvore de recursos. Omita esse atributo e o estado do recurso é determinado de acordo com msidbFeatureAttributesDisallowAdvertise e msidbFeatureAttributesFavorLocal e msidbFeatureAttributesFavorSource. Para garantir que o estado do recurso filho sempre siga o estado de seu pai, mesmo quando o filho e o pai estiverem inicialmente definidos como ausentes no Controle SelectionTree, você deve incluir msidbFeatureAttributesFollowParent e msidbFeatureAttributesUIDisallowAbsent nos atributos do recurso filho. Observe que se você definir msidbFeatureAttributesFollowParent sem definir msidbFeatureAttributesUIDisallowAbsent, o instalador não poderá forçar o recurso filho para fora do estado ausente. Nesse caso, o recurso filho corresponderá ao estado de instalação do pai somente se o filho estiver definido como algo diferente de ausente. Defina msidbFeatureAttributesFollowParent e msidbFeatureAttributesUIDisallowAbsent para garantir que um recurso filho siga o estado do recurso pai.
msidbFeatureAttributesFavorAdvertise	4	0x0004	Defina esse atributo e o estado do recurso é Anunciar. Se o recurso estiver listado pela propriedade ADDDEFAULT esse bit for ignorado e o estado do recurso for determinado de acordo com msidbFeatureAttributesFavorLocal e msidbFeatureAttributesFavorSource. Omita esse atributo e o estado do recurso é determinado de acordo com msidbFeatureAttributesDisallowAdvertise e msidbFeatureAttributesFavorLocal e msidbFeatureAttributesFavorSource.
msidbFeatureAttributesDisallowAdvertise	8	0x0008	Observe que esse bit funciona apenas com recursos listados pela propriedade ADVERTISE. Defina esse atributo para impedir que o recurso seja anunciado. Defina esse atributo e, se o recurso listado não for pai ou filho, o recurso será instalado de acordo com msidbFeatureAttributesFavorLocal e msidbFeatureAttributesFavorSource. Defina esse atributo para o pai de um recurso listado e o pai está instalado. Defina esse atributo para o filho de um recurso listado e o estado do filho está Ausente. Omita esse atributo e, se o recurso listado não for pai ou filho, o estado do recurso será Anúncio. Omita esse atributo e, se o recurso listado for pai ou filho, o estado de ambos os recursos será Anúncio.
msidbFeatureAttributesUIDisallowAbsent	16	0x0010	Defina esse atributo e a interface do usuário não exibe uma opção para alterar o estado do recurso para Absent. Definir esse atributo força o recurso ao estado de instalação, independentemente de o recurso ser ou não visível na interface do usuário. Omita esse atributo e a interface do usuário exibe uma opção para alterar o estado do recurso para Absent. Defina msidbFeatureAttributesFollowParent e msidbFeatureAttributesUIDisallowAbsent para garantir que um recurso filho siga o estado do recurso pai. Definir esse atributo não só afeta a interface do usuário, mas também força o recurso ao estado de instalação se o recurso está visível na interface do usuário ou não.
msidbFeatureAttributesNoUnsupportedAdvertise	32	0x0020	Defina esse atributo e a publicidade será desabilitada para o recurso se o shell do sistema operacional não oferecer suporte a descritores do Windows Installer. Omita esse atributo e a publicidade não está desabilitada.

 

Alguns atributos são exclusivos uns dos outros. A tentativa de definir esses atributos no mesmo recurso faz com que o pacote de instalação falhe de Validação de Pacote.

• Não use msidbFeatureAttributesFavorAdvertise com msidbFeatureAttributesDisallowAdvertise.
• Não use msidbFeatureAttributesNoUnsupportedAdvertise com msidbFeatureAttributesDisallowAdvertise juntos.
• Não use msidbFeatureAttributesFollowParent com msidbFeatureAttributesFavorSource.
• Observe que os valores msidbFeatureAttributesFollowParent e msidbFeatureAttributesFavorLocal são mutuamente exclusivos. Se o valor msidbFeatureAttributesFollowParent for usado, o valor msidbFeatureAttributesFavorLocal será considerado não existente.

Observe que, se um recurso filho estiver instalado, seu recurso pai também será instalado. Se um recurso pai estiver instalado, seu recurso filho não será necessariamente instalado, a menos que seus atributos msidbFeatureAttributesFollowParent e msidbFeatureAttributesUIDisallowAbsent sejam definidos. Essa relação hierárquica da instalação de recursos pai e filho também é usada para instalações e instalações de GUI que usam propriedades de linha de comando.

Observações

Várias colunas temporárias adicionais são adicionadas a essa tabela quando ela é carregada na memória para cálculos usados pela seleção de interface do usuário e de custo.

Um componente pode ser compartilhado entre dois ou mais recursos ou aplicativos. Se dois ou mais recursos se referirem ao mesmo componente, esse componente será selecionado para instalação se algum dos recursos associados estiver selecionado. Isso também pode ser o motivo pelo qual os recursos filho não são desinstalados quando um recurso pai é removido. Se o recurso filho consistir em componentes necessários para outros recursos ou aplicativos, o Windows Installer não removerá o recurso filho.

Para obter mais informações, consulte Controlando estados de seleção de recursos.

Nível de instalação:

• Para qualquer instalação, há um nível de instalação definido, que é um valor integral de 1 a 32.767. O valor inicial é determinado pela propriedade INSTALLLEVEL, que é definida no Property Table.
• Um recurso será instalado somente se o valor de nível de recurso for menor ou igual ao nível de instalação atual. A interface do usuário pode ser criada para que, quando a instalação for inicializada, o Instalador permita que o usuário modifique o nível de instalação de qualquer recurso na Tabela de Recursos. Por exemplo, um autor pode definir valores de nível de instalação que representam opções de instalação específicas, como Personalizado, Típico ou Mínimo e, em seguida, criar uma caixa de diálogo que usa SetInstallLevel ControlEvents para permitir que o usuário selecione um desses estados.
• Dependendo do estado selecionado pelo usuário, a caixa de diálogo define a propriedade de nível de instalação como o valor correspondente. Se o autor atribuir Típico um nível de 100 e o usuário selecionar típico, somente esses recursos com um nível igual ou menor serão instalados. Além disso, a opção Personalizado pode levar a outra caixa de diálogo que contém um de Controle SelectionTree. Em seguida, o Controle SelectionTree permite que o usuário altere individualmente se cada recurso está instalado ou não.

Validação

ICE03
ICE06
ICE10
ICE14
ice21
ICE32
ICE41
ICE45
ICE47
ICE50
ICE57
ICE59
ICE62
ICE67
ICE79
ICE86
ICE94