ICategorizer  Interface

IID_ICategorizer

{A3B14589-9174-49A8-89A3-06A1AE2B9BA7}

This interface provides methods that are used to obtain information about item identifier lists.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

ICategorizer Methods

Description

GetDescription

Retrieves the name of a categorizer, such as Group By Device Type, that can be displayed in the user interface (UI).

GetCategory

Retrieves a list of categories associated with a list of identifiers.

GetCategoryInfo

Retrieves information about a category, such as the default display and the text to display in the user interface.

CompareCategory

Determines the relative order of two items in their item identifier lists.

GetDescription

FUNCTION Proto_ICategorizer_GetDescription ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pszDesc AS DWORD _
, BYREF cch AS DWORD _
  ) AS LONG
 

FUNCTION ICategorizer_GetDescription ( _
  BYVAL pthis AS DWORD PTR _
, BYREF strDesc AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG

  LOCAL pszDesc AS DWORD
  LOCAL cch AS DWORD
  CALL DWORD @@pthis[3] USING Proto_ICategorizer_GetDescription (pthis, pszDesc, cch) TO HRESULT
  IF HRESULT = %S_OK THEN

     strDesc = ACODE$(PEEK$(pszDesc, cch))

     CoTaskMemFree pszDesc

  END IF
  FUNCTION = HRESULT

END FUNCTION
 

GetCategory

FUNCTION ICategorizer_GetCategory ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL cidl AS DWORD _
, BYVAL apidl AS DWORD _
, BYREF rgCategoryIds AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING ICategorizer_GetCategory (pthis, cidl, apidl, rgCategoryIds) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetCategoryInfo

FUNCTION ICategorizer_GetCategoryInfo ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwCategoryId AS DWORD _
, BYREF pci AS CATEGORY_INFO _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[5] USING ICategorizer_GetCategoryInfo (pthis, dwCategoryId, pci) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

CompareCategory

FUNCTION ICategorizer_CompareCategory ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL csfFlags AS DWORD _
, BYVAL dwCayegoryId1 AS DWORD _
, BYVAL dwCayegoryId1 AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[6] USING ICategorizer_CompareCategory (pthis, csfFlags, dwCategory1, dwCategory2) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION