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) |