IXpsOMFontResource::SetContent method (xpsobjectmodel.h)

Sets the read-only stream to be associated with this resource.

Syntax

HRESULT SetContent(
  [in] IStream            *sourceStream,
  [in] XPS_FONT_EMBEDDING embeddingOption,
  [in] IOpcPartUri        *partName
);

Parameters

[in] sourceStream

The read-only stream to be associated with this resource.

[in] embeddingOption

The XPS_FONT_EMBEDDING value that describes how the resource is to be obfuscated.

[in] partName

The part name to be assigned to this resource.

Return value

If the method succeeds, it returns S_OK; otherwise, it returns an HRESULT error code.

Remarks

The calling method should treat this stream as a single-threaded apartment (STA) model object and not re-enter any of the stream interface's methods.

The stream assigned to this resource should not be obfuscated. Obfuscation of the font resource takes place during serialization.

Providing an obfuscated font stream while setting the embeddingOption to XPS_FONT_EMBEDDING_OBFUSCATED will result in a font that is not obfuscated in the serialized XPS document.

partName resets the part name for this object and is checked against the value of embeddingOption for the proper obfuscation syntax.

Because GetStream gets a clone of the stream that is set by this method, the provided stream should have an efficient cloning method. A stream with an inefficient cloning method will reduce the performance of GetStream.

Requirements

See also

IOpcPartUri

IXpsOMFontResource

XML Paper Specification

XPS_FONT_EMBEDDING