IXpsOMSignatureBlockResource
COM公式ドキュメント
署名ブロックリソースへの IStream インターフェイスを提供します。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
リソースを含む IXpsOMDocument インターフェイスへのポインターを取得します。(IXpsOMSignatureBlockResource.GetOwner)
| owner | IXpsOMDocument** | out | リソースを含む IXpsOMDocument インターフェイスへのポインター。リソースがドキュメントの一部でない場合は、NULL ポインターが返されます。 |
戻り値
メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
このリソースに関連付けられているストリームの、新しい読み取り専用のコピーを取得します。(IXpsOMSignatureBlockResource.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 メソッドのパフォーマンスに依存します。
このリソースに関連付ける読み取り専用ストリームを設定します。(IXpsOMSignatureBlockResource.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_IXpsOMSignatureBlockResource "{4776AD35-2E04-4357-8743-EBF6C171A905}"
#usecom global IXpsOMSignatureBlockResource IID_IXpsOMSignatureBlockResource "{}"
#comfunc global IXpsOMSignatureBlockResource_GetOwner 5 sptr
#comfunc global IXpsOMSignatureBlockResource_GetStream 6 sptr
#comfunc global IXpsOMSignatureBlockResource_SetContent 7 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。