ISyncChangeBatchBase::BeginOrderedGroup メソッド (winsync.h)

変更バッチで順序付けされたグループを開きます。 このグループは、項目 ID で順序付けされます。

構文

HRESULT BeginOrderedGroup(
  [in] const BYTE *pbLowerBound
);

パラメーター

[in] pbLowerBound

この順序付けされたグループのアイテム ID のクローズされた下限。 下限を 0 に指定するには、 NULL を使用します。

戻り値

可能な戻りコードには、次の表に示す値が含まれますが、これらに限定されません。

リターン コード 説明
S_OK
 メソッドが成功しました。
SYNC_E_INVALID_OPERATION
 グループが既に開いているか、空のグループが以前にバッチに追加されました。
SYNC_E_CHANGE_BATCH_IS_READ_ONLY
 オブジェクトは ISyncFullEnumerationChangeBatch オブジェクトであり、グループは既にバッチに追加されています。
SYNC_E_RANGE_OUT_OF_ORDER
 オブジェクトは ISyncFullEnumerationChangeBatch オブジェクトで、 pbLowerBound はバッチの作成に使用された下限 ID より大きくなります。

解説

このメソッドが呼び出された後に変更バッチに追加された項目の変更は、開いているグループに追加されます。 順序付けされたグループに追加されるアイテムの変更は、アイテム ID ごとに順番に追加する必要があります。

グループが開かれるまで、アイテムの変更を変更バッチに追加することはできません。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winsync.h

関連項目

ISyncChangeBatchBase インターフェイス

  • Last updated on