PSCreateMemoryPropertyStore 函数 (propsys.h)

创建内存中属性存储。

语法

PSSTDAPI PSCreateMemoryPropertyStore(
  [in]  REFIID riid,
  [out] void   **ppv
);

参数

[in] riid

类型: REFIID

对请求的接口 ID 的引用。

[out] ppv

类型: void**

当此函数返回时,包含指向所需接口的指针,通常是 IPropertyStoreIPersistSerializedPropStorage

返回值

类型: HRESULT

如果此函数成功,它将返回 S_OK。 否则,它将返回 HRESULT 错误代码。

注解

此函数创建一个内存中属性存储对象,该对象实现 IPropertyStoreINamedPropertyStoreIPropertyStoreCacheIPersistStreamIPropertyBagIPersistSerializedPropStorage

内存属性存储与文件不对应,旨在用作缓存。 IPropertyStore::Commit 是一个不操作,并且仅当对象存在时,存储在对象中的数据才会保留。

内存属性存储是线程安全的。 它聚合自由线程封送器,并使用关键节来保护其数据成员。

示例

以下示例作为较大程序的一部分包含,演示如何使用 PSCreateMemoryPropertyStore

IPropertyStore *ppropstore;

HRESULT hr = PSCreateMemoryPropertyStore(IID_PPV_ARGS(&ppropstore));

if (SUCCEEDED(hr))
{
    // ppropstore is now valid.  
    ppropstore->Release();
}

要求

   
最低受支持的客户端 具有 SP2、Windows Vista 的 Windows XP [仅限桌面应用]
最低受支持的服务器 具有 SP1 的 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 propsys.h
Library Propsys.lib
DLL Propsys.dll (6.0 或更高版本)
可再发行组件 Windows 桌面搜索 (WDS) 3.0

请参阅

PSCreateMultiplexPropertyStore