CUSTOM_FIELDS_INDEX 構造体

メタデータ ストアにある項目の検索を効率化するために使用される単一列または複数列インデックスを表します。

typedef struct _CUSTOM_FIELDS_INDEX
{
  LPCWSTR * ppcszCustomFieldNames;
  BYTE cCustomFields;
  BOOL fUniqueIndex;
} CUSTOM_FIELDS_INDEX;

メンバー

  • ppcszCustomFieldNames
    インデックス付きフィールド名の一覧です。
  • cCustomFields
    ppcszCustomFieldNames の名前の数。
  • fUniqueIndex
    インデックスが項目を一意に識別している場合は TRUE、そうでない場合は FALSE

解説

インデックスのスキーマは、レプリカのメタデータを初期化するときに ISyncMetadataStore::InitializeReplicaMetadata を使用して定義されます。インデックスのスキーマに含まれているフィールドは、レプリカ用に定義されたカスタム フィールド スキーマ内にも存在する必要があります。

インデックスが一意の場合に、特定の値セットでインデックス フィールドをクエリすると、最大 1 個の項目が生成されます。また、値のセットが同じもう 1 つの項目をメタデータ ストアに追加しようとすると、エラーが発生します。

後日インデックスが IReplicaMetadata::FindItemMetadataByUniqueIndexedFields などの特定のメソッドを Metadata Storage Services で使用できるように、レプリカのメタデータを初期化するときに、インデックスを一意に定義しておく必要があります。

必要条件

ヘッダー : Metastore.h

参照

概念

Sync Framework Metadata Storage Service のコンポーネント