IPropertyDescription::GetRelativeDescription 方法 (propsys.h)

以属性说明指定的方式比较两个属性值。 返回描述两个属性比较方式的两个显示字符串。

语法

HRESULT GetRelativeDescription(
  [in]  REFPROPVARIANT propvar1,
  [in]  REFPROPVARIANT propvar2,
  [out] LPWSTR         *ppszDesc1,
  [out] LPWSTR         *ppszDesc2
);

参数

[in] propvar1

类型: REFPROPVARIANT

PROPVARIANT 结构的引用,该结构包含第一个属性的类型和值。

[in] propvar2

类型: REFPROPVARIANT

PROPVARIANT 结构的引用,该结构包含第二个属性的类型和值。

[out] ppszDesc1

类型: LPWSTR*

此方法返回时,包含指向描述字符串的指针的地址,该字符串将第一个属性与第二个属性进行比较。 字符串以 null 结尾。

[out] ppszDesc2

类型: LPWSTR*

此方法返回时,包含指向说明字符串的指针的地址,该字符串将第二个属性与第一个属性进行比较。 字符串以 null 结尾。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法受属性的 .propdesc 文件中 displayInfo 元素的 relativeDescriptionType 属性的影响。

调用应用程序负责在不再需要 ppszDesc1ppszDesc2 时通过 CoTaskMemFree 发布它们。

要求

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

另请参阅

IPropertyDescription

属性说明架构