Edit

PSGetImageReferenceForValue function (propsys.h)

  • Article

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:

Return code Description
TYPE_E_ELEMENTNOTFOUND

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

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header propsys.h (include Propsys.idl)
Library Propsys.lib
DLL Propsys.dll (version 6.0 or later)