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

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

IXpsOMDocument インターフェイスを作成します。このインターフェイスには、順序付けられたシーケンス内に IXpsOMPageReference インターフェイスのセットを含めることができます。

構文

HRESULT CreateDocument(
  [in]          IOpcPartUri    *partUri,
  [out, retval] IXpsOMDocument **document
);

パラメーター

[in] partUri

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

[out, retval] document

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

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	partUri または document が NULL です。

注釈

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


IXpsOMDocument    *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))
{
    hr = xpsFactory->CreatePartUri(partUriString, &partUri);
    
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreateDocument (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