IOpcFactory::CreatePartUri メソッド (msopc.h)

[アーティクル]
03/13/2024

パーツ名を表すパーツ URI オブジェクトを作成します。

構文

HRESULT CreatePartUri(
  [in]          LPCWSTR     pwzUri,
  [out, retval] IOpcPartUri **partUri
);

パラメーター

[in] pwzUri

パーツを含むパッケージのルートに対する相対的なパーツの位置を表す URI。

[out, retval] partUri

パーツ URI オブジェクトの IOpcPartUri インターフェイスへのポインター。このオブジェクトは、 pwzUri で渡された URI から派生したパーツ名を表します。

パーツ名は OPC で指定された構文に準拠している必要があります。

戻り値

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

リターンコード/値	説明
S_OK	メソッドが成功しました。
E_POINTER	pwzUri パラメーターと partUri パラメーターの少なくとも 1 つが NULL です。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名を空の文字列 "" にすることはできません。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名を '/' にすることはできません。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名を "//" で始めることはできません。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名の末尾を '/' にすることはできません。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名の末尾を '.' にすることはできません。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名には、'.' で終わるセグメントを含めることはできません。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名にフラグメントコンポーネントを含めることはできません。「 RFC 3986: URI ジェネリック構文」で説明されているように、フラグメントコンポーネントの前に '#' 文字が付きます。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名は、別のリレーションシップパーツを、そこに含まれるリレーションシップのソースとして示すリレーションシップパーツの名前にすることはできません。
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	パーツ名を絶対 URI にすることはできません。 RFC 3986: URI ジェネリック構文で説明されているように、絶対 URI はスキーマコンポーネントの後に ":" が続きます。
CreateUri 関数エラー	CreateUri 関数からの HRESULT エラーコード。
WinINet エラー	WinINet API からの HRESULT エラーコード。

注釈

以前の Windows バージョンでのサポート

このメソッドの動作とパフォーマンスは、サポートされているすべての Windows バージョンで同じです。詳細については、「Packaging API を使用したはじめに」および「Windows Vista 用プラットフォーム更新プログラム」を参照してください。

スレッドセーフ

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

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

要件

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