Método Provider::Commit (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 Commit é usado para enviar uma instância para o WMI. Esse método é uma função auxiliar e não deve ser substituído.

Sintaxe

HRESULT Commit(
  CInstance *pInstance,
  bool      bCache
);

Parâmetros

pInstance

Ponteiro para a instância a ser armazenada pelo WMI.

bCache

Indica se um cache é implementado. Esse valor deve ser definido como FALSE na versão atual da estrutura do provedor.

Retornar valor

Use as macros SUCCEEDED ou FAILED no HRESULT retornado para determinar se o método foi bem-sucedido.

Comentários

Se o cliente cancelar a consulta, o método Commit retornará um erro. Um gravador de provedor pode usar esse fato para encerrar uma enumeração.

Além disso, esse método chama CInstance::Release no ponteiro pInstance . Por isso, o provedor de estrutura deve ter cuidado para não chamar CInstance::Release novamente. Isso significa que um ponteiro inteligente pInstance é incompatível com esse método porque o ponteiro inteligente chama CInstance::Release em seu destruidor.

Esse método só deve ser usado quando o provedor de estrutura não chamar CInstance::Release no ponteiro pInstance separadamente e se o ponteiro pInstance não for, e nunca será, um ponteiro inteligente.

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