IPropertyDescriptionAliasInfo::GetAdditionalSortByAliases method (propsys.h)

Gets the address of a pointer to the IPropertyDescriptionList interface, which contains additional sort column values.

Syntax

HRESULT GetAdditionalSortByAliases(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameters

[in] riid

Type: REFIID

A reference to the identifier of the requested IPropertyDescriptionList interface.

[out] ppv

Type: void**

When this method returns successfully, contains the address of a pointer to an IPropertyDescriptionList interface.

Return value

Type: HRESULT

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

Remarks

The following is an example usage for this method. When sorting by System.Author: System.DateModified, System.DateCreated, and System.ItemNameDisplay may be used as secondary sort columns. This ensures a unique sort order (for System.Author) and is used to provide a more consistent user experience.

Calling applications include any UI that wants the secondary sort columns for a given property.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header propsys.h

See also

IPropertyDescriptionAliasInfo

IPropertyDescriptionAliasInfo::GetSortByAlias