IXpsOMFontResource::SetContent method

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

sourceStream [in]

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

embeddingOption [in]

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

ValueMeaning
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.

 

partName [in]

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

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

IXpsOMFontResource
IOpcPartUri
XPS_FONT_EMBEDDING
XML Paper Specification

 

 

Show: