[函数发现可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]
提供一种机制,使提供程序无需实现 IProviderProperties 即可持久保存属性。 每当客户端在函数实例属性存储上调用 IPropertyStore::Commit 时,将调用此方法。
语法
HRESULT InstancePropertyStoreFlush(
[in] IFunctionInstance *pIFunctionInstance,
[in] INT_PTR iProviderInstanceContext
);
参数
[in] pIFunctionInstance
指向 IFunctionInstance 接口的 指针。
[in] iProviderInstanceContext
与特定函数实例关联的上下文。
返回值
此方法可以返回其中一个值。
可能的返回值包括但不限于以下内容。
| 返回代码 | 说明 |
|---|---|
|
该方法已成功完成。 |
|
提供程序不实现实例属性存储。 |
|
其中一个参数包含无效参数。 |
|
方法无法分配执行此操作所需的内存。 |
注解
如果提供程序保留通过 SetValue 传递的新值缓存在内存中,则此方法应实现代码以将更新的值保存到基础 API/存储中。
如果实现此方法,则应调用 OpenPropertyStore 以在保留数据之前返回当前属性存储。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | functiondiscoveryprovider.h |