Partilhar via


Qualificadores opcionais

Os qualificadores opcionais abordam situações recorrentes não comuns a todas as implementações compatíveis com CIM, que não são necessárias para interpretar esses qualificadores. Qualificadores opcionais são fornecidos na especificação para evitar qualificadores aleatórios definidos pelo usuário que podem ocorrer nessas situações recorrentes.

Delete

Tipo de dados: booliano

Aplica-se a: associações, referências

Nas associações, indica se a associação qualificada deve ser excluída se algum dos objetos referenciados na associação for excluído e se o respectivo objeto referenciado na associação for qualificado com IfDeleted. O padrão é FALSE.

Nas referências, esse qualificador indica se o objeto referenciado deve ser excluído se a associação que contém a referência for excluída e qualificada com IfDeleted ou se qualquer um dos objetos referenciados na associação for excluído e o respectivo objeto referenciado na associação for qualificado com IfDeleted.

Uso: os aplicativos devem acompanhar associações e referências marcadas com o qualificador Delete e excluir a associação ou a referência adequadamente. Se um objeto na associação tiver sido excluído, mas não estiver marcado com IfDeleted, a associação não deverá ser excluída.

Essa regra de uso deve ser verificada quando o modelo de segurança do CIM é definido.

Expensive

Tipo de dados: booliano

Aplica-se a: propriedades, referências, classes, associações, métodos

Indica se a ação implícita requer computação abrangente. O padrão é FALSE.

IfDeleted

Tipo de dados: booliano

Aplica-se a: associações e referências

Indica se todos os objetos dentro de uma associação qualificada por Delete devem ser excluídos se o objeto referenciado ou a associação for excluída. O padrão é FALSE.

Indexed

Tipo de dados: booliano

Aplica-se a: propriedades, métodos

Indica se uma propriedade de classe deve ser indexada. Quando aplicado a propriedades em classes hospedadas pelo repositório, só tem o significado de criar (no momento da criação da classe) uma pesquisa rápida de consulta secundária para essa propriedade.

Somente o valor TRUE (padrão) é permitido.

Invisible

Tipo de dados: booliano

Aplica-se a: associações, propriedades, métodos, referências, classes

Indica se a associação é definida apenas para fins internos (por exemplo, para definição de semântica de dependência) e não deve ser exibida (por exemplo, em mapas). O padrão é FALSE.

Large

Tipo de dados: booliano

Aplica-se a: propriedades, classes

Indica se a propriedade ou classe requer uma grande quantidade de espaço de armazenamento. O padrão é FALSE.

Not_Null

Tipo de dados: booliano

Aplica-se a: propriedades

Indica se uma propriedade de classe não pode assumir um valor NULL (VT_NULL). Somente o valor TRUE (padrão) é permitido.

Se esse qualificador for especificado, o WMI não permitirá a criação de instâncias com a propriedade definida como NULL e as propriedades NULL retornarão o código de erro WBEM_E_ILLEGAL_NULL.

Observe que os qualificadores Key e Indexed já trazem esse comportamento implícito.

Provider

Tipo de dados: string

Aplica-se a: qualquer conceito

Indicação de que o elemento do esquema é dinâmico e, portanto, preenchido por um provedor. O padrão é NULL. Esse qualificador é um manipulador específico da implementação da instrumentação.

Experimental

Tipo de dados: booliano

Aplica-se a: qualquer conceito

Indica que o elemento especificado foi proposto para fazer parte de uma versão futura dos esquemas CIM, mas ainda não faz parte do esquema padrão. Em vez disso, o elemento está disponível para os usuários experimentarem, implementarem e fornecerem comentários. Com base nos comentários, o elemento pode ser adicionado ao padrão conforme apresentado, modificado ou removido. O padrão é FALSE. Uma implementação não precisa dar suporte a um elemento com esse qualificador.

Syntax

Tipo de dados: string

Aplica-se a: propriedades, referências, métodos, parâmetros

Tipo específico atribuído a um item de dados. O padrão é NULL.

Uso: você deve usar o qualificador SyntaxType com esse qualificador.

SyntaxType

Tipo de dados: string

Aplica-se a: propriedades, referências, métodos, parâmetros

Formato do qualificador Syntax. O padrão é NULL.

Uso: você deve usar o qualificador Syntax com esse qualificador.

TriggerType

Tipo de dados: string

Aplica-se a: classes, propriedades, métodos, associações, indicações, referências

Circunstâncias em que um gatilho é disparado. O padrão é NULL. Os tipos de gatilho variam de acordo com o constructo do meta-modelo.

Em classes e associações, os valores permitidos são:

Criar

Excluir

Atualizar

Access

Em propriedades e referências, os valores permitidos são: Update e Access.

Nos métodos, os valores permitidos são Before e After.

Em indicações, o valor permitido é Thrown.

UnknownValues

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: propriedades

Conjunto de valores que indica que o valor da propriedade associada é desconhecido (a propriedade não pode ser considerada como tendo um valor válido ou significativo). O padrão é NULL.

As convenções e restrições usadas para definir valores desconhecidos são as mesmas aplicáveis ao qualificador ValueMap.

Observe que esse qualificador não pode ser substituído. Não é razoável permitir que uma subclasse trate um valor como um valor conhecido quando ele é tratado como desconhecido por alguma classe pai.

UnsupportedValues

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: propriedades

Conjunto de valores que indica que o valor da propriedade associada não tem suporte (a propriedade não pode ser considerada como tendo um valor válido ou significativo). O padrão é NULL.

As convenções e restrições usadas para definir valores sem suporte são as mesmas aplicáveis ao qualificador ValueMap.

Note que esse qualificador não pode ser substituído. Não é razoável permitir que uma subclasse trate um valor como um valor com suporte se ele é tratado como desconhecido por alguma classe pai.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008

Confira também

Qualificadores do WMI

Como adicionar um qualificador