Método Provider::GetObject(CInstance*,long) (provider.h)

[A classe Provider faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas para todos os novos desenvolvimentos.]

O método GetObject é chamado pelo WMI para recuperar uma instância de uma classe.

Sintaxe

HRESULT GetObject(
        CInstance *pInstance,
  [ref] long      lFlags
);

Parâmetros

pInstance

TBD

[ref] lFlags

Objeto de consulta que indica o conjunto de propriedades a serem populadas, conforme solicitado por uma chamada para Provider::GetObject.

Um provedor pode obter um ganho de desempenho significativo preenchendo apenas esses valores de propriedade solicitados. O provedor determina quais propriedades são solicitadas usando CFrameworkQuery::IsPropertyRequired. Caso contrário, o provedor deve preencher todos os valores de propriedade.

Retornar valor

A implementação do provedor de estrutura padrão desse método retorna WBEM_E_PROVIDER_NOT_CAPABLE ao método de chamada. O método IWbemServices::GetObject lista os valores retornados comuns, embora você possa optar por implementar qualquer valor retornado COM.

Comentários

O WMI geralmente invoca GetObject em resposta a uma chamada de cliente para IWbemServices::GetObject. A versão WMI de Provider::GetObject fornece uma instância com apenas as propriedades de chave preenchidas. Por outro lado, um provedor de estrutura implementado deve preencher todas as outras propriedades. O seguinte descreve uma substituição comum de GetObject:

1. Determine qual instância WMI solicitou lendo as propriedades de chave com um método Get de CInstance, como CInstance::GetCHString.
2. Preencha o restante das propriedades da instância usando os vários métodos Set da classe CInstance , como CInstance::SetByte ou CInstance::SetStringArray.

Requisitos