provider::Commit 方法 (provider.h)

[Provider 类是 WMI 提供程序框架的一部分,现在视为处于最终状态,对于影响这些库的非安全性相关问题,将不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]

Commit 方法用于将实例发送到 WMI。 此方法是一个帮助程序函数,不应重写。

语法

HRESULT Commit(
  CInstance *pInstance,
  bool      bCache
);

参数

pInstance

指向要由 WMI 存储的实例的指针。

bCache

指示是否实现缓存。 在提供程序框架的当前版本中,此值必须设置为 FALSE

返回值

使用返回的 HRESULT 上的 SUCCEEDEDFAILED 宏来确定该方法是否成功。

注解

如果客户端取消查询, 则 Commit 方法将返回错误。 提供程序编写器可以使用此事实来终止枚举。

此外,此方法在 pInstance 指针上调用 CInstance ::Release。 因此,框架提供程序必须小心不要再次调用 CInstance::Release。 这意味着 pInstance 智能指针与此方法不兼容,因为智能指针在其析构函数中调用 CInstance::Release。

仅当框架提供程序不单独对 pInstance 指针调用 CInstance::Release,并且 pInstance 指针不是且永远不会是智能指针时,才应使用此方法。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 provider.h (包括 FwCommon.h)
Library FrameDyn.lib
DLL FrameDynOS.dll;FrameDyn.dll