IPrint::SetInitialPageNum

Attempts to set the number of the first page of a document.

HRESULT SetInitialPageNum(

LONG nFirstPage	// Number of first page
);

Parameters

nFirstPage

[in] The desired first page number

Return Value

S_OK

The first page was set as requested.

E_FAIL

The first page could not be set to the indicated value.

E_UNEXPECTED

An unknown error occurred.

Remarks

Note that setting a negative first page number is legal: this may be useful in printing a portion of the document with offset page numbers from what it would normally print. Note also that not all implementations permit the initial page number to be set, as some implementations simply lack the information as to how this page information should be reflected in the final output.