virtual P6R::P6ERR P6R::p6IXSLT::setMessageOutput ( p6IDataStream *  pOutput )

pure virtual

This method supports the 'xsl:message' element.

The application decides where to output the contents of all 'xsl:message' elements. If this method is not called them all message output is ignored. This method can be called over and over again between calls to transform. It should be called before the transform method to get the output of the transform. To "turn off" a previously set data stream, call this method again with a 'NULL' value for the pOutput parameter.

Note, that the application can set the pOutput data stream to be the same as the 'pTransformResult' data stream parameter of the transform method. This would result in the output of all message elements to appear with the output of the stylesheet. The only requirement is that the pTransformResult data stream object to handle multiple calls to "beginStream" and "endStream" properly. For example, if the data stream writes to a file, then beginStream() opens the file. Multiple calls to beginStream() should do nothing once the file has been openned. This requirement exists because the XSLT processor will call beginStream() and endStream() once on all the data streams it is given.

Note, that a data stream can represent any IO mechanism such as a file or a socket, for example. So it is possible to push the output of a message element to a socket. All of this is per the design of the application.

Parameters

pOutput

[ in ] Created by caller, the output of all 'xsl:message' elements are written. This parameter can be set to NULL, which turns off output of message element contents.

Returns

Success	P6R::eOk
Failure	P6R::eNotInitialized	A successful call to intialize() must be made before calling this funciton.
	P6R::eInvalidArg	pOutput is NULL.