ISyncChangeBatchBase::BeginOrderedGroup
変更バッチ内の順序付けられているグループを開きます。このグループは、項目 ID で順序付けられています。
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
パラメータ
- pbLowerBound
[in] この順序付けられているグループの項目 ID の閉じた下限です。下限 0 を指定するには、NULL を使用します。
戻り値
S_OK
SYNC_E_INVALID_OPERATION (グループが既に開かれているか、空のグループがバッチに以前追加されている場合)
SYNC_E_CHANGE_BATCH_IS_READ_ONLY (IProviderSyncServices::DeserializeChangeBatch または IProviderSyncServices::DeserializeFullEnumerationChangeBatch を使用して ISyncChangeBatchBase オブジェクトが作成された場合か、オブジェクトが ISyncFullEnumerationChangeBatch オブジェクトで、グループがバッチに既に追加されている場合)
SYNC_E_RANGE_OUT_OF_ORDER (オブジェクトが ISyncFullEnumerationChangeBatch オブジェクトで、pbLowerBound がバッチの作成に使用された下限の ID より大きい場合)
解説
このメソッドが呼び出された後に変更バッチに追加される項目変更は、開いているグループに追加されます。順序付けられているグループに追加される項目変更は、項目 ID によって昇順で追加する必要があります。
グループを開くまで、項目変更を変更バッチに追加できません。