IXpsOMFontResource::SetContent method (xpsobjectmodel.h)

Article
07/27/2022

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.

Value	Meaning
XPS_FONT_EMBEDDING_NORMAL	Font resource is neither obfuscated nor restricted.
XPS_FONT_EMBEDDING_OBFUSCATED	Font resource is obfuscated but not restricted.
XPS_FONT_EMBEDDING_RESTRICTED	Font resource is both obfuscated and restricted.

[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

Requirement	Value
Minimum supported client	Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	xpsobjectmodel.h

Share via