IOpcRelationship::GetId メソッド (msopc.h)

リレーションシップの一意識別子を取得します。

構文

HRESULT GetId(
  [out, retval] LPWSTR *relationshipIdentifier
);

[out, retval] relationshipIdentifier

リレーションシップの識別子です。

リレーションシップの識別子は、パッケージに対して任意でローカルであり、そのためです。

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

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	relationshipIdentifier パラメーターが NULL です。

リレーションシップの識別子は、パッケージに対して任意でローカルであるため、リレーションシップを検索するのに役立ちません。

関心のある部分を見つける決定的な方法は、リレーションシップ型を使用することです。

パーツを見つけるには、いくつかの手順が必要です。パーツの検索の詳細については、「コアプロパティパーツの検索」を参照してください。

このメソッドは、 relationshipIdentifier で返される文字列によって使用されるメモリを割り当てます。メソッドが成功した場合は、 CoTaskMemFree 関数を呼び出してメモリを解放します。

リレーションシップの詳細については、 Open Packaging Conventions Fundamentals と ECMA-376 OpenXML、1st Edition、Part 2: Open Packaging Conventions (OPC) を参照してください。

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

詳細については、「Packaging API を使用したはじめに」を参照してください。

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