次の方法で共有

IXpsOMObjectFactory1::CreatePackageWriterOnFile1 メソッド (xpsobjectmodel_1.h)

  • [アーティクル]

指定した種類の XPS パッケージに XPS OM の内容を書き込むためのファイルを開きます。 このメソッドは、MSXPS ドキュメントまたは OpenXPS ドキュメントのパッケージ ライターを生成します。

構文

HRESULT CreatePackageWriterOnFile1(
  LPCWSTR                   fileName,
  LPSECURITY_ATTRIBUTES     securityAttributes,
  DWORD                     flagsAndAttributes,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

パラメーター

fileName

[in]作成するファイルの名前。

securityAttributes

[入力、一意]SECURITY_ATTRIBUTES 構造体。2 つの独立したメンバーが含まれていますが、関連するメンバーは次のとおりです。

  • lpSecurityDescriptor: 省略可能なセキュリティ記述子
  • bInheritHandle: 返されたハンドルを子プロセスによって継承できるかどうかを決定するブール値
lpSecurityDescriptor が NULL場合、返されたハンドルに関連付けられているファイルまたはデバイスには、既定のセキュリティ記述子が割り当てられます。

securityAttributesの詳細については、「CreateFile参照してください。

flagsAndAttributes

[in]作成するファイルの設定と属性を指定します。 ほとんどのファイルでは、FILE_ATTRIBUTE_NORMAL 値を使用できます。

このパラメーター 詳細については、CreateFile を参照してください。

optimizeMarkupSize

[in]XPS OM の内容が XPS パッケージに書き込まれるときに、ドキュメント マークアップがサイズに合わせて最適化されるかどうかを示すブール値。

価値 意味
TRUE
 パッケージ ライターは、最小サイズのマークアップを最適化しようとします。
FALSE
 パッケージ ライターは最適化の実行を試みません。

interleaving

[in]XPS OM の内容をファイルに書き込むときにインターリーブするかどうかを指定します。

documentSequencePartName

[in]IOpcPartUri 新しいファイル内のドキュメント シーケンスのパーツ名を含むインターフェイスです。

coreProperties

[in]IXpsOMCoreProperties、新しいファイルに指定するコア ドキュメント プロパティを含むインターフェイスです。 このパラメーターは、NULL設定できます。

packageThumbnail

[in]IXpsOMImageResource インターフェイス。新しいファイルに割り当てられるサムネイル イメージが含まれています。 このパラメーターは、NULL設定できます。

documentSequencePrintTicket

[in]新しいファイルに割り当てるパッケージ レベルの印刷チケットを含む IXpsOMPrintTicketResource インターフェイス。 このパラメーターは、NULL設定できます。

discardControlPartName

[in]破棄コントロール パーツの名前を含む IOpcPartUri インターフェイス。 このパラメーターは、NULL設定できます。

documentType

[in]パッケージ ライターのドキュメントの種類を指定します。 このパラメーターの値をXPS_DOCUMENT_TYPE_UNSPECIFIEDすることはできません。

packageWriter

[out, retval]このメソッドによって作成された新しい IXpsOMPackageWriter インターフェイスへのポインター。

戻り値

指定できる値は次のとおりですが、これらに限定されません。 ここに記載されていない XPS ドキュメント API の戻り値については、「XPS ドキュメント エラー」を参照してください。

S_OK: メソッドが成功し、packageWriter が正しく設定されました。

E_INVALIDARG: ドキュメントの種類が有効な XPS ドキュメント形式ではありません。

備考

MSXPS ドキュメントまたは OpenXPS ドキュメントのパッケージ ライターを生成するには、このメソッドを使用します。 Windows 7 でリリースされた CreatePackageWriterOnFile、MSXPS 形式の XPS ドキュメント ファイルのみが作成されます。

その他の参照

その他のリファレンス: 従来のメソッドの説明

必要条件

要件 価値
サポートされる最小クライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー xpsobjectmodel_1.h
ライブラリ 何一つ

関連項目

IXpsOMObjectFactory1