Método IPropertyDescription::GetRelativeDescription (propsys.h)

Compara dos valores de propiedad de la manera especificada por la descripción de la propiedad. Devuelve dos cadenas de presentación que describen cómo se comparan las dos propiedades.

Sintaxis

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

Parámetros

[in] propvar1

Tipo: REFPROPVARIANT

Referencia a una estructura PROPVARIANT que contiene el tipo y el valor de la primera propiedad.

[in] propvar2

Tipo: REFPROPVARIANT

Referencia a una estructura PROPVARIANT que contiene el tipo y el valor de la segunda propiedad.

[out] ppszDesc1

Tipo: LPWSTR*

Cuando este método devuelve, contiene la dirección de un puntero a la cadena de descripción que compara la primera propiedad con la segunda propiedad. La cadena termina en null.

[out] ppszDesc2

Tipo: LPWSTR*

Cuando este método devuelve , contiene la dirección de un puntero a la cadena de descripción que compara la segunda propiedad con la primera propiedad. La cadena termina en null.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método está influenciado por el atributo relativeDescriptionType del elemento displayInfo en el archivo .propdesc de la propiedad.

Es responsabilidad de la aplicación que realiza la llamada liberar ppszDesc1 y ppszDesc2 a través de CoTaskMemFree cuando ya no sean necesarios.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado propsys.h

Consulte también

IPropertyDescription

Esquema de descripción de propiedades