Share via


IXpsOMPageReference::CollectPartResources method

Creates a list of all part-based resources that are associated with the page.

Syntax

HRESULT CollectPartResources(
  [out, retval] IXpsOMPartResources **partResources
);

Parameters

  • partResources [out, retval]
    A pointer to the IXpsOMPartResources interface that contains the list of all part-based resources that are associated with the page.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the table that follows. For information about XPS document API return values that are not listed in this table, see XPS Document Errors.

Return code Description
S_OK

The method succeeded.

E_POINTER

partResources is NULL.

 

This method calls the Packaging API. For information about the Packaging API return values, see Packaging Errors.

Remarks

If the page is not loaded when this method is called, this method finds the part-based resources that are associated with this page by parsing the relationships part of the page and returns them in the partResources parameter. If the page is loaded, this method traverses the page's object model to find the part-based resources and returns them in partResources.

The list of resource parts that are returned in the IXpsOMPartResources interface is a snapshot of the document structure that is taken when the method is called. Changes made to the document after this call are not reflected in the IXpsOMPartResources interface after it is returned by this method. Likewise, changes made to the IXpsOMPartResources interface that is returned by this method will not be reflected in the document contents.

Requirements

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps]

Header

Xpsobjectmodel.h

IDL

XpsObjectModel.idl

See also

IXpsOMPageReference

IXpsOMPartResources

Packaging Errors

XPS Document Errors

XML Paper Specification