IReplicaMetadata::FindItemMetadataByUniqueIndexedFields

Restituisce la voce di metadati dell'elemento univoca con il valore specificato per il campo indicizzato.

HRESULT FindItemMetadataByUniqueIndexedFields(
  LPCWSTR * ppcszCustomFieldNames,
  IFieldValue ** ppFieldValues,
  BYTE cCustomFields,
  IItemMetadata ** ppItemMetadata);

Parametri

• ppcszCustomFieldNames
  [in, size_is(cCustomFields)] Set di nomi di campi indicizzati che definiscono gli elementi per cui eseguire la ricerca. Questi nomi di campi devono trovarsi nello stesso ordine di quello utilizzato per specificare l'indice quando è stato chiamato ISyncMetadataStore::InitializeReplicaMetadata.

• 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.

• ppItemMetadata
  [out] Restituisce la voce di metadati dell'elemento univoca con il valore specificato per il campo indicizzato.

Valore restituito

• S_OK

• S_FALSE se non viene trovato alcun elemento corrispondente.

• E_POINTER

• SYNC_E_METADATA_QUERY_REQUIRES_UNIQUE_INDEXED_FIELDS se un campo in ppcszCustomFieldNames non è stato specificato come campo di indice univoco all'inizializzazione dei metadati.

• SYNC_E_METADATA_QUERY_REQUIRES_INDEXED_FIELDS se un campo in ppcszCustomFieldNames non è stato specificato come campo di indice all'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

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

I campi di indice devono essere definiti e contrassegnati come univoci alla prima inizializzazione dei metadati della replica passando un elenco delle strutture CUSTOM_FIELDS_INDEX a ISyncMetadataStore::InitializeReplicaMetadata.

Vedere anche

Riferimento

Interfaccia IReplicaMetadata