IXpsOMColorProfileResource

カラープロファイルリソースへの IStream インターフェイスを提供します。

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

IXpsOMColorProfileResource    *newInterface;
IOpcPartUri                   *partUri;

// このスレッドで CoInitializeEx が事前に呼び出されている必要がある点に
//  暗黙的に依存しています。

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

if (SUCCEEDED(hr))
{
    // partUriString 変数と acquiredStream 変数は
    //   この例の範囲外で定義されています。
    hr = xpsFactory->CreatePartUri(
        partUriString, 
        &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreateColorProfileResource (
            acquiredStream, 
            partUri,
            &newInterface);
        if (SUCCEEDED(hr))
        {
            // newInterface を使用します

            newInterface->Release();
        }
        partUri->Release();
    }
    xpsFactory->Release();
}
else
{
    // hr で返された HRESULT のエラーを評価します
}

このリソースに関連付けられているストリームの、新しい読み取り専用のコピーを取得します。(IXpsOMColorProfileResource.GetStream)

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

このメソッドは Packaging API を呼び出します。Packaging API の戻り値については、Packaging Errors を参照してください。

このメソッドが返す IStream オブジェクトは、E_PENDING エラーを返す場合があります。これは、ストリームの長さがまだ確定していないことを示します。この動作は、標準的な IStream オブジェクトとは異なります。

このメソッドは、stream で返すストリームを作成するために、ストリームの Clone メソッドを呼び出します。そのため、このメソッドのパフォーマンスは、ストリームの Clone メソッドのパフォーマンスに依存します。

このリソースに関連付ける読み取り専用ストリームを設定します。(IXpsOMColorProfileResource.SetContent)

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

呼び出し側のメソッドは、このストリームをシングルスレッドアパートメント (STA) モデルのオブジェクトとして扱い、ストリームインターフェイスのメソッドを再入呼び出ししないようにしてください。

GetStream は、このメソッドで設定されたストリームのクローンを取得するため、指定するストリームには効率的なクローン作成メソッドが実装されている必要があります。クローン作成メソッドが非効率なストリームでは、GetStream のパフォーマンスが低下します。