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 屬性影響。

呼叫應用程式必須負責在不再需要 ppTaskMemFree 時，透過 CoTaskMemFree 發行 ppszDesc1 和 ppszDesc2。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	propsys.h

另請參閱

IPropertyDescription

屬性描述架構