provider::Commit 方法 (provider.h)
[Provider 类是 WMI 提供程序框架的一部分,现在视为处于最终状态,对于影响这些库的非安全性相关问题,将不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]
Commit 方法用于将实例发送到 WMI。 此方法是一个帮助程序函数,不应重写。
语法
HRESULT Commit(
CInstance *pInstance,
bool bCache
);
参数
pInstance
指向要由 WMI 存储的实例的指针。
bCache
指示是否实现缓存。 在提供程序框架的当前版本中,此值必须设置为 FALSE 。
返回值
使用返回的 HRESULT 上的 SUCCEEDED 或 FAILED 宏来确定该方法是否成功。
注解
如果客户端取消查询, 则 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 |