Método Provider::P utInstance(IWbemClassObject*,long,MethodContext*) (provider.h)

  • Artigo

[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 PutInstance atualiza uma instância.

Sintaxe

HRESULT PutInstance(
  IWbemClassObject *pInst,
  long             lFlags,
  MethodContext    *pContext
);

Parâmetros

pInst

TBD

lFlags

Máscara de bits de sinalizadores com informações sobre a operação de atualização. Esse é o valor especificado pelo cliente no método IWbemServices::P utInstance .

O seguinte sinalizador é manipulado por (e filtrado) pelo WMI:

  • WBEM_FLAG_RETURN_IMMEDIATELY
Os valores lFlags válidos são:
  • WBEM_FLAG_CREATE_ONLY
  • WBEM_FLAG_CREATE_OR_UPDATE
  • WBEM_FLAG_UPDATE_ONLY

pContext

TBD

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::P utInstance lista os valores retornados mais comuns, embora você possa optar por retornar qualquer código de retorno COM.

Comentários

O WMI invoca PutInstance quando um cliente chama IWbemServices::P utInstance em relação à sua classe. Você deve implementar PutInstance se o provedor de estrutura atualizar instâncias. A lista a seguir descreve uma implementação comum de PutInstance:

  1. Examine as propriedades de chave passadas pelo cliente com os métodos Get para CInstance, como CInstance::GetCHString.

    Sua implementação deve determinar se o provedor dá suporte às alterações solicitadas pelo cliente.

  2. Crie ou atualize o objeto gerenciado apropriado, conforme necessário.
  3. Retornar o valor retornado apropriado.

    Se o provedor não der suporte às alterações solicitadas pelo cliente, você deverá retornar um código de erro apropriado. Para obter uma listagem completa de códigos de erro válidos, consulte IWbemServices::P utInstance.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho provider.h (inclua FwCommon.h)
Biblioteca FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll