勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces > IWbemHiPerfProvider >

StopRefreshing Method

Previous pageReturn to chapter overviewNext page

描述

 

IWbemHiPerfProvider.StopRefreshing方法停止刷新与提供的标识符相对应的对象或枚举器。WMI Refresher调用此方法以响应客户端请求IWbemConfiguratorRefresher.Remove.提供者应检查与清理程序相关联的对象和枚举器以获取匹配的标识符。当提供程序找到一个标识符时,提供程序应该删除或释放枚举器。

 

注意如果提供程序未实现此方法,则必须返回WBEM_E_PROVIDER_NOT_CAPABLE。如果实施IWbemHiPerfProvider.CreateRefreshableEnumIWbemHiPerfProvider.CreateRefreshableObject,提供商应实施StopRefreshing.

 

C++ 语法

 

HRESULT StopRefreshing(

[in]  IWbemRefresher *pRefresher,

[in]  long lId,

[in]  long lFlags

);

 

PowerBASIC 语法

 

METHOD StopRefreshing ( _

BYVAL pRefresher AS IWbemRefresher, _

BYVAL lId AS LONG, _

BYVAL lFlags AS LONG _

) AS LONG

 

参数

 

pRefresher

 

指向IWbemRefresher对象的指针,其中包含通过调用IWbemHiPerfProvider.CreateRefresher获取的复习。

 

lId

 

一个整数,包含唯一标识停止刷新对象的刷新标识符。

 

lFlags

 

一个包含标志的整数。

 

返回值

 

此方法返回一个HRESULT,表示方法调用的状态。下表列出了HRESULT中包含的值。

 

退货代码

描述

WBEM_S_NO_ERROR

该方法成功。

WBEM_E_PROVIDER_NOT_CAPABLE

提供者不支持刷新实例对象。如果不需要更具体的代码,则在所有情况下返回此错误代码。

WBEM_S_FALSE

无法找到请求的对象或枚举器。

WBEM_E_NOT_FOUND

提供程序找不到与提供的标识符相对应的对象或枚举器。

WBEM_E_FAILED

即使操作有效,提供程序也在内部失败。

 

备注

 

没有必要调用StopRefreshing来清理刷新。只需删除复习即可。也就是释放所有引用。删除刷新会导致清除其中的所有对象和枚举器。

 

要求

 

客户

需要Windows Vista,Windows XP或Windows 2000 Professional。

服务器

需要Windows Server 2008,Windows Server 2003或Windows 2000 Server。

在Wbemprov.inc中声明。

DLL

需要Wmiprvsd.dll。