IShellItem2::GetPropertyStoreForKeys method (shobjidl_core.h)

Gets property store object for specified property keys.

Syntax

HRESULT GetPropertyStoreForKeys(
  [in]  const PROPERTYKEY     *rgKeys,
  [in]  UINT                  cKeys,
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Parameters

[in] rgKeys

Type: const PROPERTYKEY*

A pointer to an array of PROPERTYKEY structures. Each structure contains a unique identifier for each property used in creating the property store.

[in] cKeys

Type: UINT

The number of PROPERTYKEY structures in the array pointed to by rgKeys.

[in] flags

Type: GETPROPERTYSTOREFLAGS

The GETPROPERTYSTOREFLAGS constants that modify the property store object.

[in] riid

Type: REFIID

A reference to the IID of the object to be retrieved.

[out] ppv

Type: void**

When this method returns, contains the address of an IPropertyStore interface pointer.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Note  When this method is called on a property store for a file, that file is held open for the lifetime of the IPropertyStore object.
 

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)