通过

PSGetPropertySystem 函数 (propsys.h)

  • 项目

获取实现 IPropertySystem 的子系统对象的实例。

语法

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

parameters

[in] riid

类型： REFIID

对所请求接口的 IID 的引用。

[out] ppv

类型： void**

当此函数返回时，包含 riid 中请求的接口指针。 这通常是 IPropertySystem。

返回值

类型： PSSTDAPI

返回以下值之一。

返回代码 说明
S_OK
 已获取接口。
E_INVALIDARG
 ppv 参数为 NULL。

注解

在调用 PSGetPropertySystem 之前，必须使用 CoInitialize 或 OleInitialize 初始化组件对象模型 (COM) 。 COM 必须在此对象的生存期内保持初始化状态。 属性系统对象聚合自由线程封送处理程序，并且是线程安全的。

建议使用 Objbase.h 中定义的 IID_PPV_ARGS 宏打包 riid 和 ppv 参数。 此宏基于 ppv 中的 值指向的接口提供正确的 IID，这消除了编码错误的可能性。

示例

以下示例将作为更大的程序的一部分包含，演示如何使用 PSGetPropertySystem。

IPropertySystem *pSystem;

HRESULT hr = PSGetPropertySystem(IID_PPV_ARGS(&pSystem));

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

要求

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