IXpsOMObjectFactory::CreatePackageWriterOnFile メソッド (xpsobjectmodel.h)
XPS OM の内容を XPS パッケージに書き込むためのファイルを開きます。
構文
HRESULT CreatePackageWriterOnFile(
[in] LPCWSTR fileName,
[in] LPSECURITY_ATTRIBUTES securityAttributes,
[in] DWORD flagsAndAttributes,
[in] BOOL optimizeMarkupSize,
[in] XPS_INTERLEAVING interleaving,
[in] IOpcPartUri *documentSequencePartName,
[in] IXpsOMCoreProperties *coreProperties,
[in] IXpsOMImageResource *packageThumbnail,
[in] IXpsOMPrintTicketResource *documentSequencePrintTicket,
[in] IOpcPartUri *discardControlPartName,
[out, retval] IXpsOMPackageWriter **packageWriter
);
パラメーター
[in] fileName
作成するファイルの名前。
[in] securityAttributes
SECURITY_ATTRIBUTES 構造体。2 つの独立したメンバーが含まれていますが、関連するメンバーは次のとおりです。
- lpSecurityDescriptor: 省略可能なセキュリティ記述子
- bInheritHandle: 返されたハンドルを子プロセスによって継承できるかどうかを決定するブール値
[in] flagsAndAttributes
作成するファイルの設定と属性を指定します。 ほとんどのファイルでは、FILE_ATTRIBUTE_NORMAL 値を使用できます。
このパラメーター 詳細については、CreateFile を参照してください。
[in] optimizeMarkupSize
XPS OM の内容が XPS パッケージに書き込まれるときに、ドキュメント マークアップがサイズに合わせて最適化されるかどうかを示すブール値。
価値 | 意味 |
---|---|
|
パッケージ ライターは、最小サイズのマークアップを最適化しようとします。 |
|
パッケージ ライターは最適化の実行を試みません。 |
[in] interleaving
XPS OM の内容をファイルに書き込むときにインターリーブするかどうかを指定します。
[in] documentSequencePartName
IOpcPartUri 新しいファイル内のドキュメント シーケンスのパーツ名を含むインターフェイスです。
[in] coreProperties
IXpsOMCoreProperties、新しいファイルに指定するコア ドキュメント プロパティを含むインターフェイスです。 このパラメーターは、NULL
[in] packageThumbnail
IXpsOMImageResource インターフェイス。新しいファイルに割り当てられるサムネイル イメージが含まれています。 このパラメーターは、NULL
[in] documentSequencePrintTicket
新しいファイルに割り当てるパッケージ レベルの印刷チケットを含む IXpsOMPrintTicketResource インターフェイス。 このパラメーターは、NULL
[in] discardControlPartName
破棄コントロール パーツの名前を含む IOpcPartUri インターフェイス。 このパラメーターは、NULL
[out, retval] packageWriter
このメソッドによって作成された新しい IXpsOMPackageWriter インターフェイスへのポインター。
戻り値
このメソッドは、HRESULTを返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。 この表に記載されていない XPS ドキュメント API の戻り値については、「XPS ドキュメント エラー」を参照してください。
リターン コード | 形容 |
---|---|
|
メソッドは成功しました。 |
|
|
|
coreProperties、 |
このメソッドは、Packaging API を呼び出します。 Packaging API の戻り値の詳細については、「パッケージ化エラー
備考
ファイルが開いて初期化され、返される IXpsOMPackageWriter インターフェイスを使用して、コンテンツ タイプ、パッケージ リレーションシップ、コア プロパティ、ドキュメント シーケンス リソース、およびドキュメント シーケンス リレーションシップを記述します。
documentSequencePrintTicket
documentSequencePrintTicket
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
サポートされる最小サーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | xpsobjectmodel.h |
関連項目
CreateFile の
IXpsOMCoreProperties の
IXpsOMImageResource の
IXpsOMObjectFactory の
IXpsOMPrintTicketResource の
パッケージ化エラーの を
XPS ドキュメント エラー の