IPropertyDescription::GetRelativeDescription method (propsys.h)

Compares two property values in the manner specified by the property description. Returns two display strings that describe how the two properties compare.

Syntax

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

Parameters

[in] propvar1

Type: REFPROPVARIANT

A reference to a PROPVARIANT structure that contains the type and value of the first property.

[in] propvar2

Type: REFPROPVARIANT

A reference to a PROPVARIANT structure that contains the type and value of the second property.

[out] ppszDesc1

Type: LPWSTR*

When this method returns, contains the address of a pointer to the description string that compares the first property with the second property. The string is null-terminated.

[out] ppszDesc2

Type: LPWSTR*

When this method returns, contains the address of a pointer to the description string that compares the second property with the first property. The string is null-terminated.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method is influenced by the relativeDescriptionType attribute of the displayInfo element in the property's .propdesc file.

It is the responsibility of the calling application to release ppszDesc1 and ppszDesc2 through CoTaskMemFree when they are no longer needed.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header propsys.h

See also

IPropertyDescription

Property Description Schema