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 介面