IXpsOMThumbnailGenerator interface

Article
06/01/2017

Generates a thumbnail image resource.

When to implement

Never. Custom implementation of this interface is not supported.

Members

The IXpsOMThumbnailGenerator interface inherits from the IUnknown interface. IXpsOMThumbnailGenerator also has these types of members:

Methods

Methods

The IXpsOMThumbnailGenerator interface has these methods.

Method	Description
GenerateThumbnail	Generates a thumbnail image of a page.

Remarks

To instantiate this interface, call CoCreateInstance as shown in the code example that follows.

IXpsOMThumbnailGenerator    *newInterface;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
      __uuidof(XpsOMThumbnailGenerator),
      NULL, 
      CLSCTX_INPROC_SERVER,
      __uuidof(IXpsOMThumbnailGenerator),
      reinterpret_cast<LPVOID*>(&newInterface)
      );

if (SUCCEEDED(hr))
{
    // use newInterface
    newInterface->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

This interface requires XpsRasterService.dll. If XpsRasterService.dll is not present when CoCreateInstance is called to create an IXpsOMThumbnailGenerator instance, CoCreateInstance returns E_FAIL.

Requirements

Minimum supported client	Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps only]
Header	Xpsobjectmodel.h
IDL	XpsObjectModel.idl
DLL	XpsRasterService.dll