Método Provider::D eleteInstance(ParsedObjectPath*,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 DeleteInstance é chamado pelo WMI para excluir uma instância.

Sintaxe

HRESULT DeleteInstance(
  ParsedObjectPath *pParsedObjectPath,
  long             lFlags,
  MethodContext    *pContext
);

Parâmetros

pParsedObjectPath

TBD

lFlags

Máscara de bits de sinalizadores com informações sobre a operação de exclusão. Esse é o valor especificado pelo cliente na função IWbemServices::D eleteInstance .

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

  • WBEM_FLAG_RETURN_IMMEDIATELY

pContext

TBD

Retornar valor

A implementação do provedor de estrutura padrão desse método retorna WBEM_E_PROVIDER_NOT_CAPABLE para a função de chamada. A função IWbemServices::D eleteInstance lista os valores retornados mais comuns, embora você possa optar por retornar qualquer código de retorno COM.

Comentários

O WMI invoca DeleteInstance quando um cliente chama IWbemServices::D eleteInstance em uma classe. Portanto, você deve implementar DeleteInstance se o provedor de estrutura der suporte à exclusão de instâncias. A lista a seguir descreve uma implementação comum de DeleteInstance:

  1. Determine qual instância o cliente solicitou lendo as propriedades de chave com um dos métodos Get para CInstance, como CInstance::GetCHString.
  2. Exclua a instância.
Para obter mais informações sobre como excluir instâncias, consulte IWbemServices::D eleteInstance.

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