Qualificadores específicos para o Provedor de Exibição

A seguir, lista os qualificadores usados para definir classes de Provedor de Exibição.

Observação

A classe de Provedor de Exibição só dá suporte a nomes NetBIOS ao usar referências remotas. Caso use um endereço IP ou um nome DNS em uma referência remota, a conexão falhará com um erro de 0x800706ba.

Direto

Tipo de dados: booliano

Usado com propriedades de associação de exibição para impedir que referências de associação sejam mapeadas para uma referência de exibição.

O exemplo a seguir define a propriedade GroupComponent como uma referência de associação que não é mapeada na referência de exibição.

[Direct, key, PropertySources
{"GroupComponent"}]

HiddenDefault

Tipo de dados: booliano

Valor padrão para uma propriedade de classe de exibição com base em uma propriedade de classe de origem com um valor padrão diferente. A classe de origem subjacente é implícita pela exibição.

Por exemplo, a classe de origem Win32_ScheduledJob tem uma propriedade boolianaRunRepeatedly que indica se o trabalho deve ser executado periodicamente ou apenas uma vez. O valor padrão de RunRepeatedly não é True para Win32_ScheduledJob, mas é True para a classe de exibição.

#pragma namespace("\\\\.\\root\\ns_view")
[Union,
ViewSources{"select * from Win32_ScheduledJob where RunRepeatedly=True"},
ViewSpaces{"\\\\.\\root\\cimv2"},
dynamic,provider("MS_VIEW_INSTANCE_PROVIDER")]
Class View_PeriodicJob
{
 [key, PropertySources{"JobId"}]
 uint32 JobId;
 [PropertySources{"Command"}]
 string Command;
 [HiddenDefault,PropertySources{"RunRepeatedly"}]
 boolean Repeat = True;
};

JoinOn

Tipo de dados: cadeia de caracteres

Define como as instâncias de classe de origem são unidas em classes de exibição de junção. O exemplo a seguir mostra como usar o qualificador JoinOn para unir duas classes de origem.

JoinOn("Win32Perf_RawProcess.IDProcess = Win32Perf_RawThread.IDProcess")

MethodSource

Tipo de dados: matriz de cadeia de caracteres

Método de origem a ser executado para o método de exibição. Para obter uma sintaxe semelhante, consulte Qualificador de PropertySources. A assinatura do método deve corresponder exatamente à assinatura da classe de origem. Copie a assinatura do método do arquivo do MOF que define a classe de origem. O exemplo a seguir define um método do método ClearEventLog de Win32_NTEventlogFile:

[implemented, MethodSource
{"ClearEventlog"}]
  uint32   VClearEventlog([in] string ArchiveFileName);

Esse qualificador só é válido quando é usado com exibições de união.

PostJoinFilter

Tipo de dados: cadeia de caracteres

Consulta WQL para filtrar instâncias depois que elas tiverem sido ingressadas em uma classe de junção.

PropertySources

Tipo de dados: matriz de cadeia de caracteres

Propriedades de origem das quais uma propriedade de classe de exibição obtém dados.

União

Tipo de dados: booliano

Indica se você está definindo uma classe de união. As exibições de união contêm instâncias com base na união de instâncias de origem. Por exemplo, declare o seguinte:

Union, ViewSources{"SELECT Handle, Name, CreationDate FROM Win32_Process", 
                   "SELECT Caption, Name, ProcessHandle FROM Win32_Thread"}.

ViewSources

Tipo de dados: matriz de cadeia de caracteres

Conjunto de consultas WQL (Linguagem de Consulta WMI) que definem as instâncias de origem e as propriedades usadas em uma classe de exibição específica. A correspondência posicional de todos os qualificadores de matriz é importante.

ViewSpaces

Tipo de dados: matriz de cadeia de caracteres

Namespaces em que as instâncias de origem estão localizadas.

Requisitos

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