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

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

XPS ドキュメントの IXpsOMDocumentSequence インターフェイスを作成します。このインターフェイスには、XPS ドキュメントの IXpsOMDocument インターフェイスを含めることができます。

構文

HRESULT CreateDocumentSequence(
  [in]          IOpcPartUri            *partUri,
  [out, retval] IXpsOMDocumentSequence **documentSequence
);

パラメーター

[in] partUri

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

[out, retval] documentSequence

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

戻り値

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

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

注釈

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


IXpsOMDocumentSequence    *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->CreateDocumentSequence (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