ホーム › System.WindowsSync › ISyncFullEnumerationChangeBatch
ISyncFullEnumerationChangeBatch
COM公式ドキュメント
リカバリー同期の一部として作成される変更セットのメタデータを表します。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 17 HRESULT GetLearnedKnowledgeAfterRecoveryComplete(ISyncKnowledge** ppLearnedKnowledgeAfterRecoveryComplete)
リカバリー同期内のすべての変更を適用した後に、宛先レプリカが学習するナレッジを取得します。
| ppLearnedKnowledgeAfterRecoveryComplete | ISyncKnowledge** | out | リカバリー同期内のすべての変更を適用した後に、宛先レプリカが学習するナレッジを返します。 |
戻り値
戻り値には、次の表に示す値が含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| ポインターが無効です。 | |
|
バッチにグループが追加されていないか、グループが開かれたまま終了されていません。 |
宛先バージョンを必要とするアイテム ID の閉じた下限を取得します。
| pbClosedLowerBoundItemId | BYTE* | inout | 宛先バージョンを必要とするアイテム ID の閉じた下限を返します。 |
| pcbIdSize | DWORD* | inout | pbClosedLowerBoundItemId のバイト数を指定します。pcbIdSize が小さすぎる場合は pbClosedLowerBoundItemId のサイズに必要なバイト数を返し、それ以外の場合は pbClosedLowerBoundItemId に書き込まれたバイト数を返します。 |
戻り値
戻り値には、次の表に示す値が含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| ポインターが無効です。 | |
|
pbClosedLowerBoundItemId が小さすぎます。この場合、必要なバイト数が pcbIdSize に格納されます。 |
|
バッチにグループが追加されていないか、グループが開かれたまま終了されていません。 |
解説(Remarks)
宛先プロバイダーがこの変更バッチを処理する際は、指定された閉じた下限と閉じた上限の間(両端を含む)にあるアイテム ID を持つ自身のすべてのアイテムについて、バージョン情報を提供する必要があります。
宛先バージョンを必要とするアイテム ID の閉じた上限を取得します。
| pbClosedUpperBoundItemId | BYTE* | inout | 宛先バージョンを必要とするアイテム ID の閉じた上限を返します。 |
| pcbIdSize | DWORD* | inout | pbClosedUpperBoundItemId のバイト数を指定します。pcbIdSize が小さすぎる場合は pbClosedUpperBoundItemId のサイズに必要なバイト数を返し、それ以外の場合は pbClosedUpperBoundItemId に書き込まれたバイト数を返します。 |
戻り値
戻り値には、次の表に示す値が含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| ポインターが無効です。 | |
|
pbClosedLowerBoundItemId が小さすぎます。この場合、必要なバイト数が pcbIdSize に格納されます。 |
|
バッチにグループが追加されていないか、グループが開かれたまま終了されていません。 |
解説(Remarks)
宛先プロバイダーがこの変更バッチを処理する際は、指定された閉じた下限と閉じた上限の間(両端を含む)にあるアイテム ID を持つ自身のすべてのアイテムについて、バージョン情報を提供する必要があります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_ISyncFullEnumerationChangeBatch "{EF64197D-4F44-4EA2-B355-4524713E3BED}" #usecom global ISyncFullEnumerationChangeBatch IID_ISyncFullEnumerationChangeBatch "{}" #comfunc global ISyncFullEnumerationChangeBatch_GetLearnedKnowledgeAfterRecoveryComplete 17 sptr #comfunc global ISyncFullEnumerationChangeBatch_GetClosedLowerBoundItemId 18 var,var #comfunc global ISyncFullEnumerationChangeBatch_GetClosedUpperBoundItemId 19 var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ISyncFullEnumerationChangeBatch "{EF64197D-4F44-4EA2-B355-4524713E3BED}" #usecom global ISyncFullEnumerationChangeBatch IID_ISyncFullEnumerationChangeBatch "{}" #comfunc global ISyncFullEnumerationChangeBatch_GetLearnedKnowledgeAfterRecoveryComplete 17 sptr #comfunc global ISyncFullEnumerationChangeBatch_GetClosedLowerBoundItemId 18 sptr,sptr #comfunc global ISyncFullEnumerationChangeBatch_GetClosedUpperBoundItemId 19 sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。