ISearchItem::GetUIObjectOf method

Gets the user interface (UI) object of ISearchItem.

Syntax

HRESULT GetUIObjectOf(
  [in, optional] LCID   locale,
  [out]          REFIID riid,
  [out]          void   **ppUIObject
);

Parameters

  • locale [in, optional]
    Type: LCID

    Any valid locale ID (LCID) constant.

  • riid [out]
    Type: REFIID

    IID of the interface. Reserved for future use. Must be IID_NULL.

  • ppUIObject [out]
    Type: void**

    On return, contains the address of a pointer to the ISearchItem object.

Return value

Type: HRESULT

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

Remarks

The ISearchItem::GetUIObjectOf method is supported only on Windows XP and Windows Server 2003, and should no longer be used.

To preview attachments with a third-party protocol handler on computers running Windows XP or Windows Server 2003, it may be necessary to use the ISearchItem interface, and the following APIs: the IItemPreviewerExt, IItemPropertyBag, and ISearchProtocolUI interfaces, the LINKINFO structure, and the LINKTYPE enumeration.

Requirements

Minimum supported client

Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Redistributable

Windows Desktop Search (WDS) 3.0

See also

ISearchItem