Interface IWbemObjectAccess (wbemcli.h)

A interface IWbemObjectAccess fornece acesso aos métodos e propriedades de um objeto . Um objeto IWbemObjectAccess é um contêiner de uma instância atualizada por um atualizador. Com a interface IWbemObjectAccess , você pode obter e definir propriedades usando identificadores de propriedade em vez de nomes de propriedade de objeto.

Nota Essa interface não é implementada por aplicativos cliente ou provedores em nenhuma circunstância. A implementação fornecida pelo WMI é a única com suporte. Um ponteiro para a interface pode ser recuperado chamando IWbemClassObject::QueryInterface.

 

Herança

A interface IWbemObjectAccess herda da interface IUnknown . IWbemObjectAccess também tem estes tipos de membros:

Métodos

A interface IWbemObjectAccess tem esses métodos.

IWbemObjectAccess::GetPropertyHandle O método GetPropertyHandle retorna um identificador exclusivo que identifica uma propriedade. Você pode usar esse identificador para identificar propriedades ao usar métodos IWbemObjectAccess para ler ou gravar valores de propriedade.
IWbemObjectAccess::GetPropertyInfoByHandle O método GetPropertyInfoByHandle retorna o nome e o tipo de dados da propriedade associada a um identificador de propriedade.
IWbemObjectAccess::Lock O método Lock impede que outros threads atualizem um objeto IWbemObjectAccess até que ele seja desbloqueado.
IWbemObjectAccess::ReadDWORD O método ReadDWORD lê 32 bits de dados de propriedade usando um identificador de propriedade.
IWbemObjectAccess::ReadPropertyValue O método ReadPropertyValue retorna um número especificado de bytes de uma propriedade associada a um identificador de propriedade.
IWbemObjectAccess::ReadQWORD O método ReadQWORD lê 64 bits de dados de propriedade identificados por um identificador de propriedade.
IWbemObjectAccess::Unlock O método Unlock permite que outros threads atualizem os valores de propriedade de um objeto IWbemObjectAccess.
IWbemObjectAccess::WriteDWORD O método WriteDWORD grava 32 bits de dados em uma propriedade identificada por um identificador de propriedade.
IWbemObjectAccess::WritePropertyValue O método WritePropertyValue grava um número especificado de bytes em uma propriedade identificada por um identificador de propriedade. Use esse método para definir a cadeia de caracteres e todos os outros dados não DWORD ou não QWORD.
IWbemObjectAccess::WriteQWORD O método WriteQWORD grava 64 bits de dados em uma propriedade usando um identificador de propriedade.

Comentários

Os métodos IWbemObjectAccess que leem e gravam dados executam muito pouca validação de dados. Como os métodos IWbemObjectAccess acessam diretamente as propriedades, você pode obter e definir propriedades muito mais rapidamente do que pode usar técnicas de acesso a objetos padrão, como IWbemClassObject::Get e IWbemClassObject::P ut.

Nota Para maximizar sua velocidade, IWbemObjectAccess está completamente desmarcado . É responsabilidade do usuário garantir que todos os identificadores sejam adequados e que os buffers de gravação sejam dimensionados corretamente. As operações de leitura e gravação não são intrinsecamente thread-safe. Você deve chamar os métodos IWbemObjectAccess::Lock e IWbemObjectAccess::Unlock para impedir que objetos IWbemObjectAccess acessem simultaneamente em vários threads.

 

Os identificadores de propriedade são os mesmos para todas as instâncias de uma classe. Portanto, só é necessário recuperar um identificador uma vez.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (include Wbemidl.h)

Confira também

Acessar dados de desempenho do C++

Como acessar classes de desempenho pré-instaladas do WMI

API COM para WMI

IWbemRefresher