通过

IPropertyBag：：Read 方法 (oaidl.h)

  • 项目

将命名属性读入调用方初始化的 VARIANT。

语法

HRESULT Read(
  LPCOLESTR pszPropName,
  VARIANT   *pVar,
  IErrorLog *pErrorLog
);

参数

pszPropName

要读取的属性的名称的地址。 不能为 NULL。

pVar

调用方初始化的 VARIANT 的地址，该变量在输出时接收属性值。 函数在返回之前设置 VARIANT 中的类型字段和值字段。 如果调用方在输入时初始化了 pVar->vt 字段，则属性包会尝试将其对应的值更改为此类型。 如果调用方将 pVar->vt 设置为 VT_EMPTY，则属性包可以使用任何方便的类型。

pErrorLog

调用方错误日志的地址，属性包在其中存储读取期间发生的任何错误。 这可以是 NULL;在这种情况下，调用方不会收到错误。

返回值

An HRESULT

注解

Read 方法告知属性包将 pszPropName 中名为 的属性读取到 pVar 中调用方初始化的 VARIANT。 错误记录在 pErrorLog 指向的错误日志中。 当指定另一个对象指针 (VT_UNKNOWN) 时 pVar->vt ，属性包负责创建和初始化 pszPropName 描述的对象。

E_NOTIMPL不是有效的返回代码，因为实现此接口的任何对象都必须支持接口的整个功能。

要求

要求 值
最低受支持的客户端 Windows 10内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
标头 oaidl.h