PSGetImageReferenceForValue function (propsys.h)

Gets an instance of a property description interface for a specified property.

Syntax

PSSTDAPI PSGetImageReferenceForValue(
  [in]  REFPROPERTYKEY propkey,
  [in]  REFPROPVARIANT propvar,
  [out] PWSTR          *ppszImageRes
);

Parameters

[in] propkey

Type: REFPROPERTYKEY

A reference to a PROPERTYKEY structure that specifies the property.

[in] propvar

Type: REFIID

A reference to the IID of the interface to retrieve through ppv.

[out] ppszImageRes

Type: void**

When this function returns successfully, contains the interface pointer requested in riid.

Return value

Type: HRESULT

Returns S_OK if successful, or an error value otherwise, including the following:

Remarks

We recommend that you use the IID_PPV_ARGS macro, defined in Objbase.h, to package the riid and ppv parameters. This macro provides the correct IID based on the interface pointed to by the value in ppv, which eliminates the possibility of a coding error in riid that could lead to unexpected results.

Requirements