IPerPropertyBrowsing：：GetPredefinedValue 方法 (ocidl.h)

  • 项目

检索与预定义字符串名称关联的指定属性的值。 此属性与从 IPerPropertyBrowsing：：GetPredefinedStrings 返回的预定义字符串名称相关联。 预定义字符串由从 GetPredefinedStrings 返回的令牌标识。

语法

HRESULT GetPredefinedValue(
  [in]  DISPID  dispID,
  [in]  DWORD   dwCookie,
  [out] VARIANT *pVarOut
);

参数

[in] dispID

为其请求预定义值的属性的调度标识符。

[in] dwCookie

标识要返回的值的标记。 令牌以前在由 GetPredefinedStrings 填充的 pCaCookiesOut 数组中返回。

[out] pVarOut

指向属性的 VARIANT 值的指针。

返回值

此方法可以返回标准返回值E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及以下值。

返回代码 说明
S_OK
 该方法已成功完成。
E_NOTIMPL
 此对象不支持预定义字符串或预定义值。
E_POINTER
 pVarOut 中的地址无效。 例如，它可能为 NULL。

注解

调用方备注

调用方负责释放 VARIANT 中包含的任何分配。 除非 variant 的vt 成员VT_VARIANT，否则调用方可以使用对 VariantClear 的单个调用来释放内存。 否则，调用方必须在释放外部 VARIANT 之前以递归方式释放包含 的 VARIANT 值。

实施者说明

不需要支持预定义的名称和值。 如果对象不支持这些名称，请从此方法返回E_NOTIMPL。 如果未实现此方法，则也不得实现 IPerPropertyBrowsing：：GetPredefinedStrings 。

此方法分配 VARIANT 内所需的任何内存。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

另请参阅

IPerPropertyBrowsing