IReplicaMetadata::FindItemMetadataByIndexedFields
指定された値をインデックス付きフィールドに持つ項目メタデータ エントリの一覧を返します。
HRESULT FindItemMetadataByIndexedFields(
LPCWSTR * ppcszCustomFieldNames,
IFieldValue ** ppFieldValues,
BYTE cCustomFields,
IItemMetadataEnumerator ** ppItemMetadataEnumerator);
パラメーター
- ppcszCustomFieldNames
[in, size_is(cCustomFields)] 検索する項目を定義するインデックス付きフィールド名のセット。
- ppFieldValues
[in, size_is(cCustomFields)] 検索対象項目を定義するインデックス付きフィールド値のセット。これらの値は、ppcszCustomFieldNames に指定されている名前と同じ順序にする必要があります。
- cCustomFields
[in] ppcszCustomFieldNames および ppFieldValues のエントリ数。
- ppItemMetadataEnumerator
[out] 指定された値をインデックス付きフィールドに持つ項目メタデータ エントリの一覧を返します。
戻り値
S_OK
E_POINTER
メタデータが初期化されたときに、ppcszCustomFieldNames のフィールドをインデックス付きフィールドと指定しなかった場合は SYNC_E_METADATA_QUERY_REQUIRES_INDEXED_FIELDS。
ppcszCustomFieldNames のフィールド名が存在しない場合は SYNC_E_METADATA_FIELD_INVALID_NAME。
ppFieldValues のフィールド値が、対応するフィールドの型と一致しない場合は SYNC_E_METADATA_FIELD_INVALID_TYPE。
解説
指定されたインデックス付きフィールド値を持つ項目がない場合は、空の列挙子が返されます。
カスタム フィールドは、レプリカ メタデータを初めて初期化するときに、CUSTOM_FIELD_DEFINITION 構造体の一覧を ISyncMetadataStore::InitializeReplicaMetadata に渡して確立する必要があります。