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.
Tipo de dados: cadeia de caracteres
Consulta WQL para filtrar instâncias depois que elas tiverem sido ingressadas em uma classe de junção.
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"}.
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.
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 |