Classe __ObjectProviderRegistration

  • Artigo

A classe do sistema abstrata __ObjectProviderRegistration serve como a classe pai para classes que são usadas para registrar provedores de classe e instância no WMI.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética e não na ordem do MOF.

Sintaxe

[abstract]
class __ObjectProviderRegistration : __ProviderRegistration
{
  sint32         InteractionType = 0;
  __Provider REF provider;
  string         QuerySupportLevels[];
  boolean        SupportsBatching;
  boolean        SupportsDelete = False;
  boolean        SupportsEnumeration = False;
  boolean        SupportsGet = False;
  boolean        SupportsPut = False;
  boolean        SupportsTransactions;
};

Membros

A classe __ObjectProviderRegistration tem estes tipos de membros:

Propriedades

A classe __ObjectProviderRegistration tem estas propriedades.

InteractionType

Tipo de dados: sint32

Tipo de acesso: leitura/gravação

Indica se o provedor de classe ou instância fornece ou não os próprios dados ou depende do WMI e do repositório do CIM (Common Information Model). Os provedores de pull dão suporte ao acesso dinâmico a seus dados e os provedores de push armazenam dados no repositório do CIM e dependem do WMI para fornecer acesso a eles. Para obter mais informações, confira Determinar o status de push ou pull. O valor padrão é 0 (zero).

Pull (0)

O provedor é um provedor de pull.

Push (1)

O provedor é um provedor de push.

PushVerify (2)

O provedor é um provedor de push-verify. Observe que o push-verify não tem suporte neste momento.

provedor

Tipo de dados: __Provider

Tipo de acesso: Somente leitura

Referência a uma instância do __Provider que representa um caminho de objeto para o provedor de objetos. Essa propriedade é herdada de __ProviderRegistration.

QuerySupportLevels

Tipo de dados: matriz string

Tipo de acesso: leitura/gravação

Matriz dos tipos de suporte incluído pelo provedor para processamento da consulta. Os provedores de classe não dão suporte a nenhum tipo de consulta. Os provedores de instância poderão definir QuerySupportLevels como NULL se não derem suporte ao processamento de consultas. Os provedores que dão suporte a consultas implementam o método IWbemServices::ExecQueryAsync e definem essa propriedade como um ou mais dos valores a seguir (o tipo de propriedade é uma matriz).

"WQL:UnarySelect"

"WQL:References"

"WQL:Associators"

"WQL:V1ProviderDefined"

SupportsBatching

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Não usado.

SupportsDelete

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Se for True, o provedor dará suporte à exclusão de dados.

Verdadeiro

O provedor dá suporte à exclusão de classe ou instância implementando IWbemServices::D eleteClassAsync (provedores de classe) ou IWbemServices::D eleteInstanceAsync (provedores de instância).

Falso

O provedor não dá suporte à exclusão de dados e retorna WBEM_E_PROVIDER_NOT_CAPABLE de DeleteClassAsync ou DeleteInstanceAsync.

SupportsEnumeration

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Se for True, o provedor dá suporte à enumeração de dados.

Verdadeiro

O provedor dá suporte à enumeração de dados implementando IWbemServices::CreateClassEnumAsync (provedores de classe) ou IWbemServices::CreateInstanceEnumAsync (provedores de instância).

Falso

O provedor não dá suporte à enumeração de dados e retorna WBEM_E_PROVIDER_NOT_CAPABLE de CreateClassEnumAsync ou CreateInstanceEnumAsync.

SupportsGet

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Se for True, o provedor de classe ou instância dá suporte à recuperação de dados.

Verdadeiro

O provedor dá suporte à recuperação de dados implementando IWbemServices::GetObjectAsync.

Falso

O provedor não dá suporte à recuperação de dados e retorna WBEM_E_PROVIDER_NOT_CAPABLE de GetObjectAsync.

SupportsPut

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Se True, o provedor de classe ou de instância dá suporte à modificação de dados.

Verdadeiro

O provedor dá suporte à modificação de classe ou instância implementando IWbemServices::PutClassAsync (provedores de classe) ou IWbemServices::PutInstanceAsync (provedores de instância).

Falso

O provedor não dá suporte à modificação de dados e retorna WBEM_E_PROVIDER_NOT_CAPABLE de PutClassAsync ou PutInstanceAsync.

SupportsTransactions

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Não usado.

Comentários

A classe __ObjectProviderRegistration é derivada de __ProviderRegistration.

Os provedores de classe devem definir a propriedade SupportsEnumeration como True porque os provedores devem ser capazes de fornecer ao WMI uma lista de suas classes. Se um provedor de classe tentar definir essa propriedade como False, o WMI sinalizará o registro como ilegal. Os provedores de instância não são necessários para dar suporte à enumeração e podem optar por definir SupportsEnumeration como True ou False.

Um provedor que define QuerySupportLevels como "WQL:UnarySelect" pode aceitar uma consulta que consiste na instrução SELECT básica, conforme o suporte da versão 1.0 do WMI. Espera-se que os provedores de classe e de instância possam manipular a propriedade do sistema __CLASS. Espera-se também que os provedores de classe processem a propriedade do sistema __SUPERCLASS e o operador ISA. O operador ISA é usado para expandir um conjunto de resultados para classes derivadas. Se um provedor receber uma consulta que não possa interpretar, ele solicitará que o WMI a manipule retornando o valor de erro WBEM_E_TOO_COMPLEX. Para obter uma descrição da sintaxe WQL válida, confira Como consultar com WQL.

Um provedor que define QuerySupportLevels como WQL:V1ProviderDefined pode tentar dar suporte a um conjunto maior da sintaxe SQL por conta própria, como a cláusula ORDER BY. O WMI não interpreta as cláusulas adicionais nem tenta garantir que o conjunto de resultados esteja correto.

Somente os administradores podem registrar ou excluir um provedor criando uma instância de __Win32Provider e registrando-o.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Todos os namespaces do WMI

Confira também

__ProviderRegistration

Classes do sistema do WMI

Registrar um provedor