IXpsOMPrintTicketResource
COM公式ドキュメント
PrintTicket リソースへの IStream インターフェイスを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
このリソースに関連付けられているストリームの、新しい読み取り専用のコピーを取得します。(IXpsOMPrintTicketResource.GetStream)
| stream | IStream** | out | このリソースに関連付けられているストリームの、新しい読み取り専用のコピー。 |
戻り値
メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。
このメソッドは Packaging API を呼び出します。Packaging API の戻り値については、Packaging Errors を参照してください。
解説(Remarks)
このメソッドが返す IStream オブジェクトは、E_PENDING エラーを返す場合があります。これは、ストリームの長さがまだ確定していないことを示します。この動作は、標準の IStream オブジェクトとは異なります。
このメソッドは、stream に返すストリームを作成するために、ストリームの Clone メソッドを呼び出します。そのため、このメソッドのパフォーマンスは、ストリームの Clone メソッドのパフォーマンスに依存します。
このリソースに関連付ける読み取り専用のストリームを設定します。(IXpsOMPrintTicketResource.SetContent)
| sourceStream | IStream* | in | このリソースに関連付ける読み取り専用のストリーム。 |
| partName | IOpcPartUri* | in | このリソースに割り当てるパート名。 |
戻り値
メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
呼び出し元のメソッドは、このストリームをシングルスレッドアパートメント (STA) モデルのオブジェクトとして扱い、ストリームインターフェイスのメソッドを再入してはなりません。
GetStream は、このメソッドで設定されたストリームのクローンを取得するため、指定するストリームには効率的なクローン作成メソッドが必要です。クローン作成メソッドが非効率なストリームは、GetStream のパフォーマンスを低下させます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IXpsOMPrintTicketResource "{E7FF32D2-34AA-499B-BBE9-9CD4EE6C59F7}"
#usecom global IXpsOMPrintTicketResource IID_IXpsOMPrintTicketResource "{}"
#comfunc global IXpsOMPrintTicketResource_GetStream 5 sptr
#comfunc global IXpsOMPrintTicketResource_SetContent 6 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。