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

[アーティクル]
12/22/2023

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

構文

HRESULT CreateFontResource(
  [in]          IStream            *acquiredStream,
  [in]          XPS_FONT_EMBEDDING fontEmbedding,
  [in]          IOpcPartUri        *partUri,
  [in]          BOOL               isObfSourceStream,
  [out, retval] IXpsOMFontResource **fontResource
);

パラメーター

[in] acquiredStream

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

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

注意このストリームは難読化されません。

[in] fontEmbedding

ストリームの埋め込みオプションを指定するXPS_FONT_EMBEDDING値。

[in] partUri

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

[in] isObfSourceStream

acquiredStream によって参照されるストリームが難読化されているかどうかを示すブール値。

値	意味
True	acquiredStream によって参照されるストリームは難読化されます。
False	acquiredStream によって参照されるストリームは難読化されません。

[out, retval] fontResource

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

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	次のいずれかのエラーが発生しました。 fontEmbedding は有効な XPS_FONT_EMBEDDING 値ではありません。 fontEmbedding が XPS_FONT_EMBEDDING_NORMAL され、 isObfSourceStream が TRUE です。
E_POINTER	acquiredStream、 partUri、または fontResource が NULL です。

注釈

isObfSourceStream の値は、フォントリソースが作成された時点での acquiredStream 参照ストリームの状態を表します。 GetStream または SetContent に対する後続のすべての呼び出しは、難読化されていないバージョンの IStream に対して動作します。

isObfSourceStream が TRUE に設定され、fontEmbedding がXPS_FONT_EMBEDDING_NORMALに設定されている場合、または partUri によって参照される名前が難読化ストリームの構文に準拠していない場合は、エラーが返されます。

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


IXpsOMFontResource    *newInterface;
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->CreateFontResource (
            acquiredStream, 
            XPS_FONT_EMBEDDING_NORMAL,    // normal
            partUri, 
            FALSE,                        // not obfuscated
            &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