IOpcRelationshipSet::CreateRelationship メソッド (msopc.h)

[アーティクル]
10/26/2023

指定したリレーションシップを表すリレーションシップオブジェクトを作成し、オブジェクトの IOpcRelationship インターフェイスへのポインターをセットに追加します。

構文

HRESULT CreateRelationship(
  [in]          LPCWSTR             relationshipIdentifier,
  [in]          LPCWSTR             relationshipType,
  [in]          IUri                *targetUri,
  [in]          OPC_URI_TARGET_MODE targetMode,
  [out, retval] IOpcRelationship    **relationship
);

パラメーター

[in] relationshipIdentifier

リレーションシップオブジェクトとして表されるリレーションシップの一意識別子。ランダムに生成された識別子を使用するには、このパラメーターに NULL を 渡します。

有効な識別子は xsd:ID の制限に準拠しています。これは、「W3C 推奨事項のセクション 3.3.8 ID,XML スキーマパート 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID)」に記載されています。

[in] relationshipType

リレーションシップオブジェクトとして表されるリレーションシップのロールを定義するリレーションシップの種類。

[in] targetUri

リレーションシップオブジェクトとして表されるリレーションシップのターゲットへの URI。

targetMode の値がOPC_URI_TARGET_MODE_INTERNALの場合、target は部分であり、URI はリレーションシップのソースを基準とする必要があります。

targetMode の値がOPC_URI_TARGET_MODE_EXTERNALの場合、target はパッケージの外部のリソースであり、URI は絶対またはパッケージの場所に対する相対値である可能性があります。

リレーションシップのターゲットの URI の詳細については、 OPC を参照してください。

[in] targetMode

リレーションシップオブジェクトとして表されるリレーションシップのターゲットがパッケージの内部か外部かを示す値。

[out, retval] relationship

リレーションシップを表すリレーションシップオブジェクトの IOpcRelationship インターフェイスへのポインター。

新しいオブジェクトへのポインターが不要な場合、このパラメーターは NULL にすることができます。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード/値	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	targetMode パラメーターで渡される値は、有効なOPC_URI_TARGET_MODE列挙値ではありません。
E_POINTER	relationshipType パラメーターと targetUri パラメーターの少なくとも 1 つが NULL です。
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	同じ識別子を持つリレーションシップが、現在のパッケージに既に存在します。
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	リレーションシップの Id 属性は、 OPC で指定された規則に準拠していません。
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	targetUri の URI は絶対であり、targetMode の値はOPC_URI_TARGET_MODE_INTERNAL。このターゲットモードが指定されている場合、ターゲットの URI は相対 URI である必要があります。
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	リレーションシップの Target 属性は、 OPC で指定された規則に準拠していません。
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	リレーションシップの Type 属性は、 OPC で指定された規則に準拠していません。
パッケージの使用エラー	パッケージ消費エラーグループの HRESULT エラーコード。
パーツ URI エラー	パーツ URI エラーグループからの HRESULT エラーコード。

注釈

リレーションシップオブジェクトが作成され、そのオブジェクトへのポインターがセットに追加されると、そのオブジェクトが表すリレーションシップはパッケージの保存時に保存されます。

IOpcRelationship インターフェイスは、リレーションシッププロパティへのアクセスを提供します。これらのプロパティの詳細については、「リレーションシップの概要」と「IOpcRelationship」を参照してください。

スレッドセーフ

パッケージ化オブジェクトはスレッドセーフではありません。

詳細については、Packaging API を使用したはじめにに関するページを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msopc.h