IXpsOMObjectFactory::CreateImageResource メソッド (xpsobjectmodel.h)

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

イメージリソースストリームへのアクセスに使用される IXpsOMImageResource インターフェイスを作成します。

構文

HRESULT CreateImageResource(
  [in]          IStream             *acquiredStream,
  [in]          XPS_IMAGE_TYPE      contentType,
  [in]          IOpcPartUri         *partUri,
  [out, retval] IXpsOMImageResource **imageResource
);

パラメーター

[in] acquiredStream

このリソースに関連付ける読み取り専用ストリーム。このパラメーターは NULL にすることはできません。

大事な このストリームは、Single-Threaded アパートメント (STA) オブジェクトとして扱います。再入力しないでください。

[in] contentType

acquiredStream によって参照されるストリームのイメージの種類を表すXPS_IMAGE_TYPE値。

[in] partUri

このリソースに割り当てるパーツ名を含む IOpcPartUri インターフェイス。このパラメーターは NULL にすることはできません。

[out, retval] imageResource

新しい IXpsOMImageResource インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に含まれる値が含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメントエラー」を参照してください。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	contentType が有効な XPS_IMAGE_TYPE 値ではありません。
E_POINTER	acquiredStream、 partUri、または imageResource が NULL です。

注釈

次のコード例は、このメソッドを使用して新しいインターフェイスを作成する方法を示しています。


IXpsOMImageResource    *newInterface;
// The following values are defined outside of 
// this example.
//  IStream            *acquiredStream;
//  XPS_IMAGE_TYPE     contentType;
//  IOpcPartUri        *partUri;
    
// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    // The partUriString and acquiredStream variables 
    //   are defined outside of this example.
    hr = xpsFactory->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreateImageResource (
            acquiredStream,
            contentType,
            partUri,
            &newInterface);
        if (SUCCEEDED(hr))
        {
            // use newInterface

            newInterface->Release();
        }
        partUri->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

要件

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