Método Provider::P utInstance(constCInstance&,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 PutInstance atualiza uma instância.

Sintaxe

HRESULT PutInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Parâmetros

[ref] newInstance

Instância atualizada.

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

• WBEM_FLAG_CREATE_ONLY
• WBEM_FLAG_CREATE_OR_UPDATE
• WBEM_FLAG_UPDATE_ONLY

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