IXpsOMFontResource

フォントリソースへの IStream インターフェースを提供します。

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

IXpsOMFontResource    *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->CreateFontResource (
            acquiredStream, 
            XPS_FONT_EMBEDDING_NORMAL,    // 通常
            partUri, 
            FALSE,                        // 難読化しない
            &newInterface);
        if (SUCCEEDED(hr))
        {
            // newInterface を使用する

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

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

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

このメソッドは Packaging API を呼び出します。Packaging API の戻り値については、パッケージングのエラーを参照してください。

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

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

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

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。

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

このリソースに割り当てるストリームは、難読化されていてはいけません。フォントリソースの難読化は、シリアル化の際に行われます。

embeddingOption に XPS_FONT_EMBEDDING_OBFUSCATED を指定した状態で難読化済みのフォントストリームを渡すと、シリアル化された XPS ドキュメント内で難読化されていないフォントになります。

partName はこのオブジェクトのパート名を再設定するもので、難読化の構文が適切であるかどうかが embeddingOption の値と照合して確認されます。

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

リソースがシリアル化されるときに適用される埋め込みオプションを取得します。

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。