IXpsOMPackageWriter::AddResource メソッド (xpsobjectmodel.h)

パッケージに新しいパーツリソースを作成します。

構文

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

[in] resource

パッケージの新しいパーツとして追加されるパーツリソースの IXpsOMResource インターフェイス。このパラメーターで渡される可能性があるリソースの種類については、「解説」を参照してください。

このメソッドは HRESULT を返します。使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメントエラー」を参照してください。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	リソースによって参照されているリソースと同じ名前のリソースが既にストリームに追加されているか、リソースによって参照されるリソースを含むリレーションシップがありません。 E_INVALIDARGが返された後、ストリームまたはファイルは無効になり、Close はXPS_E_UNAVAILABLE_PACKAGEを返します。
XPS_E_UNAVAILABLE_PACKAGE	重大なエラーが発生し、XPS OM の内容が回復できない可能性があります。 XPS OM の一部のコンポーネントは、検証後にのみ使用できる場合があります。このエラーが返された後に XPS OM の状態を予測できないため、XPS OM のすべてのコンポーネントを解放して破棄する必要があります。

このメソッドは Packaging API を呼び出します。パッケージ化 API の戻り値の詳細については、「パッケージ化エラー」を参照してください。

このメソッドは、 リソースに対応する新しいパーツをドキュメントパッケージに作成し、 リソース の内容を新しいパーツに追加してから、新しいパーツを閉じます。

このメソッドからエラーが返された場合、パッケージライターは使用できなくなります。

resource パラメーターは、次のいずれかである必要があります。

現在のページまたは既に追加されているページで使用されているフォントリソースの IXpsOMFontResource インターフェイス。
現在のページまたは既に追加されているページで使用されているイメージリソースの IXpsOMImageResource インターフェイス。
現在のページまたは既に追加されているページで使用されているカラープロファイルリソースの IXpsOMColorProfileResource インターフェイス。
現在のページまたは既に追加されているページで使用されているストーリーフラグメントリソースの IXpsOMStoryFragmentsResource インターフェイス。
現在のドキュメントまたは既に追加されているドキュメントで使用されているドキュメント構造リソースの IXpsOMDocumentStructureResource インターフェイス。
現在のドキュメントまたは既に追加されているドキュメントで使用されている署名ブロックリソースの IXpsOMSignatureBlockResource インターフェイス。

リソースに次 のいずれかが含まれている 場合、このメソッドはエラーを返します。

このメソッドは、既にストリームに追加されているリソースと同じ名前のリソース、または既存のリレーションシップがないリソースをリソースが参照している場合にエラーを返します。

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	xpsobjectmodel.h