ICategoryProvider::CanCategorizeOnSCID method (shobjidl_core.h)

Determines whether a column can be used as a category.

Syntax

HRESULT CanCategorizeOnSCID(
  [in] const SHCOLUMNID *pscid
);

Parameters

[in] pscid

Type: const SHCOLUMNID*

A pointer to a SHCOLUMNID structure that identifies the column. Valid only when S_OK is returned. The GUID contained in this structure is then passed to ICategoryProvider::CreateCategory.

Return value

Type: HRESULT

Returns S_OK if the column can be used as a category or S_FALSE if not.

Remarks

When using the System Folder View Object in Category view (Show in Groups), the titles of columns for which this method returns S_OK appear in the upper portion of the Arrange Icons By submenu.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll