IReplicaMetadata::FindItemMetadataByIndexedFields

Restituisce un elenco di voci di metadati dell'elemento con il valore specificato per il campo indicizzato.

HRESULT FindItemMetadataByIndexedFields(
  LPCWSTR * ppcszCustomFieldNames,
  IFieldValue ** ppFieldValues,
  BYTE cCustomFields,
  IItemMetadataEnumerator ** ppItemMetadataEnumerator);

Parametri

• ppcszCustomFieldNames
  [in, size_is(cCustomFields)] Set di nomi di campi indicizzati che definiscono gli elementi per cui eseguire la ricerca.

• ppFieldValues
  [in, size_is(cCustomFields)] Set di valori di campi indicizzati che definiscono gli elementi per cui eseguire la ricerca. Questi valori devono trovarsi nello stesso ordine dei nomi in ppcszCustomFieldNames.

• cCustomFields
  [in] Numero di voci in ppcszCustomFieldNames e in ppFieldValues.

• ppItemMetadataEnumerator
  [out] Restituisce l'elenco di voci di metadati dell'elemento con i valori specificati per i campi indicizzati.

Valore restituito

• S_OK

• E_POINTER

• SYNC_E_METADATA_QUERY_REQUIRES_INDEXED_FIELDS se un campo in ppcszCustomFieldNames non è stato specificato come campo di indice al momento dell'inizializzazione dei metadati.

• SYNC_E_METADATA_FIELD_INVALID_NAME se non esiste un nome di campo in ppcszCustomFieldNames.

• SYNC_E_METADATA_FIELD_INVALID_TYPE se un valore di campo in ppFieldValues non corrisponde al tipo del campo corrispondente.

Osservazioni

Se non esistono elementi con valori di campi indicizzati specificati, viene restituito un enumeratore vuoto.

I campi personalizzati devono essere definiti alla prima inizializzazione dei metadati della replica passando un elenco delle strutture CUSTOM_FIELD_DEFINITION a ISyncMetadataStore::InitializeReplicaMetadata.

Vedere anche

Riferimento

Interfaccia IReplicaMetadata