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 来首次初始化副本元数据时，必须建立自定义字段。

请参阅

参考

IReplicaMetadata 接口