Partilhar via


Suporte a operações de instância parcial

Um provedor não é obrigado a dar suporte a nenhuma operação de instância parcial. No entanto, um provedor deve dar suporte a toda a semântica de uma operação de instância parcial, processar uma instância completa ou retornar WBEM_E_UNSUPPORTED_PARAMETER.

Ao criar um provedor que dê suporte a operações de instância parcial, você deve observar as seguintes regras:

  • Reutilize o mesmo objeto de contexto que o WMI envia ao provedor. O WMI usa o valor nomeado "__GET_EXT_CLIENT_REQUEST" para evitar deadlocks e remove esse cliente antes de encaminhar o objeto de contexto para um provedor.
  • Para chamadas reentrantes de volta ao WMI que não exigem uma operação de instância parcial, certifique-se de passar o mesmo objeto de contexto sem nenhuma modificação. O WMI recebe o objeto de contexto sem o conjunto de valores nomeados "__GET_EXT_CLIENT_REQUEST" e exclui todos os valores nomeados associados a operações de instância parcial do objeto de contexto antes de passá-lo para outros provedores. Não alterar o objeto de contexto impede que outros provedores recebam operações de recuperação de instância parcial destinadas a um objeto diferente e não relacionado.
  • Para executar uma operação de instância parcial reentrante durante a execução de uma solicitação, defina o valor nomeado "__GET_EXT_CLIENT_REQUEST" e a propriedade ausentes. Opcionalmente, você pode modificar as propriedades no valor nomeado "__GET_EXT_PROPERTIES" antes de enviar o objeto de contexto de volta para o WMI com a chamada reentrante.
  • Não acesse o objeto de contexto depois de retorná-lo ao WMI durante uma chamada reentrante. Outros provedores podem modificar as listas de propriedades ou outros valores durante a reentrância. Você pode examinar ou modificar o objeto de contexto somente durante a chamada IWbemServices implementada.