Classe provider (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.]

A classe Provider é a classe base para a classe ou classes às quais o provedor de estrutura dá suporte. A classe Provider encapsula implementações dos métodos de IWbemServices e inclui várias funções auxiliares. Um provedor de estrutura substitui um dos métodos da classe Provider para cada recurso ao qual ele dá suporte. Por exemplo, um provedor que dá suporte ao processamento de consulta substitui o método Provider::ExecQuery .

Uma instância da classe Provider é criada para cada classe WMI que tem um provedor de estrutura.

O provedor tem estes tipos de membros:

Método	Descrição
Confirmar	Retorna a instância atual para WMI.
CreateNewInstance	Aloca um novo objeto CInstance e retorna um ponteiro para ele.
DeleteInstance	Exclui uma instância. Chamado pelo WMI.
EnumerateInstances	Recupera todas as instâncias da classe de um provedor de estrutura. Chamado pelo WMI.
ExecMethod	Invoca um método em uma classe ou instância. Chamado pelo WMI.
ExecQuery	Processa uma consulta WQL (Linguagem de Consulta WMI). Chamado pelo WMI.
Liberar	Chamado pela estrutura do provedor para excluir toda a memória desnecessária em uso pelo provedor.
GetLocalComputerName	Retorna uma referência constante ao nome do computador no formato CHString .
GetLocalInstancePath	Tenta criar um caminho de objeto completo para uma instância especificada.
Getobject	Recupera uma instância de uma classe . Chamado pelo WMI.
Getprovidername	Recupera o nome do provedor.
MakeLocalPath	Cria um caminho de instância completa de um caminho relativo.
PutInstance	Atualizações uma instância. Chamado pelo WMI.
SetCreationClassName	Define a propriedade de cadeia de caracteres CreationClassName da instância fornecida como o nome desse provedor.
ValidateDeletionFlags	Determina se um conjunto de sinalizadores é válido para uma operação de exclusão.
ValidateEnumerationFlags	Determina se um conjunto de sinalizadores é válido para uma enumeração.
ValidateFlags	Determina se um conjunto de sinalizadores é válido.
ValidateGetObjFlags	Determina se um conjunto de sinalizadores é válido para uma operação de recuperação de instância.
ValidateMethodFlags	Determina se um conjunto de sinalizadores é válido para uma operação de método execute.
ValidatePutInstanceFlags	Determina se um conjunto de sinalizadores é válido para uma operação de atualização de instância.
ValidateQueryFlags	Determina se um conjunto de sinalizadores é válido para uma operação de consulta.

Herança

A classe Provider implementa CThreadBase.

Métodos

A classe Provider tem esses métodos.

Provedor::~Provider A função Provider::~Provider é um destruidor para a classe Provider.
Provider::Commit O método Commit é usado para enviar uma instância para o WMI. Esse método é uma função auxiliar e não deve ser substituído.
Provider::CreateNewInstance O método CreateNewInstance aloca um novo objeto CInstance e retorna um ponteiro para ele.
Provider::D eleteInstance O método DeleteInstance é chamado pelo WMI para excluir uma instância. (sobrecarga 2/2)
Provider::D eleteInstance O método DeleteInstance é chamado pelo WMI para excluir uma instância. (sobrecarga 1/2)
Provider::EnumerateInstances O método EnumerateInstances é chamado pelo WMI para recuperar todas as instâncias da classe de um provedor de estrutura.
Provider::ExecMethod O método ExecMethod é chamado pelo WMI para invocar um método em uma classe ou instância. (sobrecarga 1/2)
Provider::ExecMethod O método ExecMethod é chamado pelo WMI para invocar um método em uma classe ou instância. (sobrecarga 2/2)
Provider::ExecQuery O método ExecQuery é chamado pelo WMI para processar uma consulta WQL (WMI Query Language).
Provider::Flush O método Flush é chamado pela estrutura do provedor para excluir toda a memória desnecessária em uso pelo provedor.
Provider::GetLocalComputerName O método GetLocalComputerName retorna uma referência constante ao nome do computador no formato CHString.
Provider::GetLocalInstancePath O método GetLocalInstancePath tenta criar um caminho de objeto completo para uma instância especificada. Esse método é uma função auxiliar e não deve ser substituído.
Provider::GetNamespace O método GetNamespace retorna uma referência constante ao nome do namespace no formato CHString. O nome retornado é o segundo parâmetro originalmente fornecido ao construtor do provedor.
Provider::GetObject O método GetObject é chamado pelo WMI para recuperar uma instância de uma classe. (sobrecarga 1/3)
Provider::GetObject O método GetObject é chamado pelo WMI para recuperar uma instância de uma classe. (sobrecarga 2/3)
Provider::GetObject O método GetObject é chamado pelo WMI para recuperar uma instância de uma classe. (sobrecarga 3/3)
Provider::GetProviderName O método GetProviderName recupera o nome da classe usada no construtor do provedor.
Provider::MakeLocalPath O método MakeLocalPath cria um caminho de instância completo de um caminho relativo.
Provider::P rovider O método Provider cria uma instância de um provedor. Esse método faz parte do WMI Provider Framework.
Provider::P utInstance O método PutInstance atualiza uma instância. (sobrecarga 2/2)
Provider::P utInstance O método PutInstance atualiza uma instância. (sobrecarga 1/2)
Provider::SetCreationClassName O método SetCreationClassName define a propriedade de cadeia de caracteres CreationClassName, se houver, da instância fornecida como o nome desse provedor.
Provider::ValidateDeletionFlags O método ValidateDeletionFlags determina se um conjunto de sinalizadores é válido para uma operação de exclusão.
Provider::ValidateEnumerationFlags O método ValidateEnumerationFlags determina se um conjunto de sinalizadores é válido para uma enumeração.
Provider::ValidateFlags O método ValidateFlags determina se um conjunto de sinalizadores é válido.
Provider::ValidateGetObjFlags O método ValidateGetObjFlags determina se um conjunto de sinalizadores é válido para uma operação de recuperação de instância.
Provider::ValidateMethodFlags O método ValidateMethodFlags determina se um conjunto de sinalizadores é válido para uma operação de método execute.
Provider::ValidatePutInstanceFlags O método ValidatePutInstanceFlags determina se um conjunto de sinalizadores é válido para uma operação de atualização de instância.
Provider::ValidateQueryFlags O método ValidateQueryFlags determina se um conjunto de sinalizadores é válido para uma operação de consulta.

Comentários

O destruidor dessa classe é Provider::~Provider.

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)