Metodo IPropertyDescription::GetRelativeDescription (propsys.h)

Confronta due valori di proprietà nel modo specificato dalla descrizione della proprietà. Restituisce due stringhe di visualizzazione che descrivono il confronto delle due proprietà.

Sintassi

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

Parametri

[in] propvar1

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT contenente il tipo e il valore della prima proprietà.

[in] propvar2

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT che contiene il tipo e il valore della seconda proprietà.

[out] ppszDesc1

Tipo: LPWSTR*

Quando termina, questo metodo contiene l'indirizzo di un puntatore alla stringa di descrizione che confronta la prima proprietà con la seconda proprietà. La stringa è con terminazione Null.

[out] ppszDesc2

Tipo: LPWSTR*

Quando termina, questo metodo contiene l'indirizzo di un puntatore alla stringa di descrizione che confronta la seconda proprietà con la prima proprietà. La stringa è con terminazione Null.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo è influenzato dall'attributo relativeDescriptionType dell'elemento displayInfo nel file propdesc della proprietà.

È responsabilità dell'applicazione chiamante rilasciare ppszDesc1 e ppszDesc2 tramite CoTaskMemFree quando non sono più necessari.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione propsys.h

Vedi anche

IPropertyDescription

Schema Descrizione proprietà