ホーム › System.WinRT.Xaml › IReferenceTracker

IReferenceTracker

COM

IID11d3b13a-180e-4789-a8be-7712882893e6継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

XAML オブジェクトの参照を管理するために XAML フレームワークが実装するインターフェイスを定義します。

解説(Remarks)

このインターフェイスは、ほとんどの XAML フレームワークオブジェクトによって実装されます。agile として定義されておらず、アパートメント間でのマーシャリングも行いません。これを実装する XAML オブジェクトのアパートメント内からのみ使用してください。

メソッド 7

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT ConnectFromTrackerSource()

参照トラッカーソースが参照トラッカーオブジェクトに対して最初の COM 参照を作成したことを示します。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、たとえば XAML オブジェクトが out パラメーター引数として返されるときなど、XAML オブジェクトに対してランタイム呼び出し可能ラッパー (runtime-callable wrapper) が作成されるときに呼び出されます。

vtbl 4 HRESULT DisconnectFromTrackerSource()

参照トラッカーソースが参照トラッカーの追跡を停止したことを示します。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドを呼び出しても、トラッカーソースが参照トラッカー上のすべての COM 参照を解放したことを示すわけではありません。
このメソッドは、ランタイム呼び出し可能ラッパーが回収されるときに、ガベージコレクション中に CLR によって呼び出されますが、XAML オブジェクトはファイナライザースレッドで処理されるまで解放されません。

vtbl 5 HRESULT FindTrackerTargets(IFindReferenceTargetsCallback* callback)

参照トラッカーソースからどの参照トラッカーターゲットに到達可能かを調べます。ガベージコレクターが ReferenceTrackingStarted の呼び出しと FindTrackerTargetsCompleted の呼び出しの間に呼び出す必要があります。

callback

IFindReferenceTargetsCallback*

発見した参照追跡対象を報告するために呼び出される IFindReferenceTargetsCallback へのポインタである。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 6 HRESULT GetReferenceTrackerManager(IReferenceTrackerManager** value)

XAML オブジェクトから IReferenceTrackerManager インターフェイスを取得します。

value

IReferenceTrackerManager**

out

参照追跡を管理する IReferenceTrackerManager を受け取る出力先である。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 7 HRESULT AddRefFromTrackerSource()

トラッカーソースが参照トラッカーに対して IUnknown::AddRef を呼び出すたびにそのことを示します。AddRef の呼び出しの後に呼び出されます。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 8 HRESULT ReleaseFromTrackerSource()

トラッカーソースが参照トラッカーに対して IUnknown::Release を呼び出すたびにそのことを示します。Release の呼び出しの前に呼び出す必要があります。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 9 HRESULT PegFromTrackerSource()

トラッカーソースが参照トラッカーオブジェクトを保護できないことを示します。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、CLR が XAML オブジェクトを out パラメーター引数として返すときに呼び出されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IReferenceTracker "{11D3B13A-180E-4789-A8BE-7712882893E6}"
#usecom global IReferenceTracker IID_IReferenceTracker "{}"
#comfunc global IReferenceTracker_ConnectFromTrackerSource     3
#comfunc global IReferenceTracker_DisconnectFromTrackerSource  4
#comfunc global IReferenceTracker_FindTrackerTargets           5 sptr
#comfunc global IReferenceTracker_GetReferenceTrackerManager   6 sptr
#comfunc global IReferenceTracker_AddRefFromTrackerSource      7
#comfunc global IReferenceTracker_ReleaseFromTrackerSource     8
#comfunc global IReferenceTracker_PegFromTrackerSource         9
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。