IThumbnailHandlerFactory::GetThumbnailHandler method (shobjidl_core.h)

Gets the requested thumbnail handler for the thumbnail of a given item.

Syntax

HRESULT GetThumbnailHandler(
  [in]  PCUITEMID_CHILD pidlChild,
  [in]  IBindCtx        *pbc,
  [in]  REFIID          riid,
  [out] void            **ppv
);

Parameters

[in] pidlChild

Type: PCUITEMID_CHILD

The item within the namespace for which the thumbnail handler is being retrieved.

[in] pbc

Type: IBindCtx*

A pointer to an IBindCtx to be used during the moniker binding operation of this process.

[in] riid

Type: REFIID

A reference to the IID of the interface requested. This is usually IThumbnailProvider or IExtractImage.

[out] ppv

Type: void**

When this method returns, contains the address of a pointer to the requested thumbnail handler. If this method fails, this value is NULL.

Return value

Type: HRESULT

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

Remarks

Windows Vista calls the IThumbnailHandlerFactory::GetThumbnailHandler method before falling back on GetUIObjectOf.

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)