IOpcPartSet::GetPart メソッド (msopc.h)

[アーティクル]
08/25/2023

セット内の指定したパーツを表すパーツオブジェクトを取得します。

構文

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

パラメーター

[in] name

パーツのパーツ名を表すパーツ URI オブジェクトの IOpcPartUri インターフェイスへのポインター。

[out, retval] part

指定したパーツ名を持つパーツを表すパーツオブジェクトの IOpcPart へのポインター。

戻り値

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

リターンコード/値	説明
S_OK	メソッドが成功しました。
E_POINTER	name パラメーターは NULL です。
OPC_E_NO_SUCH_PART 0x80510018	指定された部分が存在しません。
パッケージの使用エラー	パッケージ消費エラーグループの HRESULT エラーコード。
パーツ URI エラー	パーツ URI エラーグループからの HRESULT エラーコード。

注釈

特定のパーツを表すパーツオブジェクトの IOpcPart インターフェイスポインターを取得するには、 PartExists メソッドを呼び出し、パーツ名を渡して、パーツがセット内で表されていることを確認します。その場合は、 GetPart メソッドを呼び出し、パーツ名を渡して IOpcPart インターフェイスポインターを取得します。

パーツ URI オブジェクトがリレーションシップパーツのパーツ名を表す場合、リレーションシップパーツがセットに含まれていないため、このメソッドは失敗します。

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

スレッドセーフ

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

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

要件

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