IOpcPartSet::CreatePart メソッド (msopc.h)
パーツを表すパーツ オブジェクトを作成し、オブジェクトの IOpcPart インターフェイスへのポインターをセットに追加します。
構文
HRESULT CreatePart(
[in] IOpcPartUri *name,
[in] LPCWSTR contentType,
[in] OPC_COMPRESSION_OPTIONS compressionOptions,
[out, retval] IOpcPart **part
);
パラメーター
[in] name
パーツのパーツ名を表すパーツ URI オブジェクトの IOpcPartUri インターフェイスへのポインター。
パーツのパーツ名を表すパーツ URI オブジェクト ( IOpcPartUri インターフェイスを実装) を作成するには、 IOpcFactory::CreatePartUri メソッドを 呼び出します。
[in] contentType
パーツ コンテンツのメディアの種類。
[in] compressionOptions
パーツのパーツ コンテンツを圧縮する方法を示す 値。
[out, retval] part
パーツを表す新しい IOpcPart へのポインター。
このパラメーターを NULL にすることはできません。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
name パラメーターは NULL です。 |
|
compressionOptions パラメーターで渡される値が、有効なOPC_COMPRESSION_OPTIONS列挙値ではありません。 |
|
指定したパーツ名を持つパーツは、現在のパッケージに既に存在します。 |
|
コンテンツ タイプは、 RFC 2616: HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) および OPC で指定されている有効なメディア タイプの規則に準拠していません。 |
|
パーツのコンテンツ タイプが、予期されるコンテンツ タイプ (OPC、 ECMA-376 Part 2 で指定) と異なっているか、パーツコンテンツがパーツのコンテンツ タイプと一致しませんでした。 |
|
パッケージ消費エラー グループの HRESULT エラー コード。 |
|
パーツ URI エラー グループからの HRESULT エラー コード。 |
注釈
パーツ オブジェクトが作成され、そのオブジェクトへのポインターがセットに追加されると、そのオブジェクトが表すパーツは、パッケージがシリアル化されるときにシリアル化されます。
このメソッドは、リレーションシップ パーツを表すパーツ オブジェクトを作成できません。
パーツ オブジェクトの作成前にパーツ コンテンツが圧縮される場合は、compressionOptions パラメーターにOPC_COMPRESSION_NONE値を渡します。
既に圧縮されているパーツ コンテンツは、それ以上圧縮されません。
IOpcPart は、パーツのプロパティへのアクセスを提供します。 これらのプロパティの詳細については、「パーツの 概要 」および 「IOpcPart 」トピックを参照してください。
スレッド セーフ
オブジェクトのパッケージ化はスレッド セーフではありません。
詳細については、「Packaging API を使用したはじめに」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msopc.h |
こちらもご覧ください
外部リソース
概要
参照